Skip to content

GROQ_SETUP.md

Latest commit

 

History

History
256 lines (186 loc) · 6.17 KB

GROQ_SETUP.md

File metadata and controls

256 lines (186 loc) · 6.17 KB

🚀 دليل إعداد Groq API - مجاني 100%!

🎉 ما هو Groq؟

Groq هو بديل مجاني وسريع جداً لـ OpenAI!

المميزات:

  • ✅ مجاني 100% - لا يحتاج بطاقة ائتمان
  • ✅ سريع جداً - أسرع من OpenAI
  • ✅ ذكي - يستخدم نماذج Llama 3.3
  • ✅ سهل - نفس طريقة OpenAI تماماً

🔑 الخطوة 1: الحصول على API Key

1. سجل في Groq

  1. اذهب إلى: https://console.groq.com
  2. اضغط "Sign Up" أو "Get Started"
  3. سجل باستخدام:
    • Google
    • أو GitHub
    • أو البريد الإلكتروني

2. أنشئ API Key

  1. بعد التسجيل، اذهب إلى: https://console.groq.com/keys
  2. اضغط "Create API Key"
  3. اختر اسم (مثل: "Chinese Bot")
  4. اضغط "Create"
  5. انسخ المفتاح فوراً! (يبدأ بـ gsk_...)

مثال:

gsk_abc123xyz456def789ghi012jkl345mno678pqr901stu234vwx567

⚙️ الخطوة 2: إضافة المفتاح للبوت

على Render.com:

  1. اذهب إلى Render Dashboard

  2. اختر خدمة البوت

    • اضغط على اسم الخدمة (مثل: btmajid)

  3. اذهب إلى Environment

    • من القائمة اليسرى، اضغط "Environment"

  4. أضف المتغير

    • اضغط "Add Environment Variable"
    • Key: GROQ_API_KEY
    • Value: gsk_your_groq_api_key_here
    • اضغط "Save Changes"

  5. انتظر إعادة النشر

    • Render سيعيد نشر البوت تلقائياً
    • انتظر 2-3 دقائق

🧪 الخطوة 3: اختبار المحادثة الذكية

1. افتح البوت على تليجرام

2. أرسل:

/ai_chat

3. اختر الوضع:

  • 🎓 معلم - للتعلم والتصحيح
  • 💬 محادثة - للممارسة
  • 🔤 مترجم - للترجمة

4. ابدأ الكتابة!

مثال:

أنت: 你好
البوت: 你好！很高兴见到你！😊
       (مرحباً! سعيد برؤيتك!)
       
       你今天怎么样？
       (كيف حالك اليوم؟)

💰 التكلفة

Groq Free Tier:

  • ✅ مجاني تماماً
  • ✅ 30 طلب/دقيقة
  • ✅ 14,400 طلب/يوم
  • ✅ لا يحتاج بطاقة ائتمان

كافي لآلاف المحادثات يومياً! 🎉

📊 المقارنة: Groq vs OpenAI

الميزة Groq OpenAI
التكلفة مجاني $0.001/محادثة
السرعة أسرع (800+ tokens/s) سريع (100 tokens/s)
الذكاء جيد جداً ممتاز
القيود 30 req/min حسب الدفع
التسجيل لا يحتاج بطاقة يحتاج بطاقة

النتيجة: Groq أفضل للاستخدام المجاني! 🏆

🛠️ استكشاف الأخطاء

خطأ: "Invalid API Key"

الحل:

  • تأكد من نسخ المفتاح كاملاً
  • يجب أن يبدأ بـ gsk_
  • لا مسافات زائدة

خطأ: "Rate limit exceeded"

الحل:

  • انتظر دقيقة
  • Groq يسمح بـ 30 طلب/دقيقة
  • كافي للاستخدام العادي

البوت لا يرد في وضع AI

الحل:

  1. تحقق من إضافة GROQ_API_KEY في Render
  2. انتظر إعادة النشر (2-3 دقائق)
  3. جرب /stop_ai ثم /ai_chat مرة أخرى
  4. شاهد Logs في Render

🎯 النماذج المتاحة في Groq

الموصى به (المستخدم حالياً):

llama-3.3-70b-versatile
  • ✅ سريع جداً
  • ✅ ذكي
  • ✅ يدعم العربية والصينية

بدائل:

llama-3.1-70b-versatile  # أقدم قليلاً
mixtral-8x7b-32768       # أسرع لكن أقل ذكاءً
gemma2-9b-it            # خفيف وسريع

🔐 الأمان

نصائح:

  1. ✅ لا تشارك API Key مع أحد
  2. ✅ لا تنشره على GitHub (استخدم .env)
  3. ✅ يمكنك حذفه وإنشاء جديد أي وقت

إذا تسرب المفتاح:

  1. اذهب إلى: https://console.groq.com/keys
  2. احذف المفتاح القديم
  3. أنشئ مفتاح جديد
  4. حدّث في Render

📈 مراقبة الاستخدام

في Groq Console:

  1. اذهب إلى: https://console.groq.com/usage
  2. شاهد:
    • عدد الطلبات
    • الاستخدام اليومي
    • النماذج المستخدمة

🎨 تخصيص المحادثة

تغيير النموذج:

في ملف ai_chat_feature.py:

model="llama-3.3-70b-versatile"  # الحالي
# أو
model="mixtral-8x7b-32768"       # أسرع

تغيير درجة الحرارة:

temperature=0.7  # متوازن (افتراضي)
# أو
temperature=0.3  # أكثر دقة
# أو
temperature=1.0  # أكثر إبداعاً

✅ قائمة التحقق

  • التسجيل في Groq
  • إنشاء API Key
  • إضافة المفتاح إلى Render
  • انتظار إعادة النشر
  • اختبار /ai_chat
  • الاستمتاع بالمحادثة الذكية المجانية!

🎉 النتيجة

البوت الآن يدعم:

  • ✅ محادثة ذكية مجانية 100%
  • ✅ 3 أوضاع مختلفة
  • ✅ سريع جداً
  • ✅ يدعم العربية والصينية
  • ✅ بدون أي تكلفة!

استمتع بالمحادثة الذكية المجانية! 🤖✨

🔗 روابط مفيدة

💡 نصيحة أخيرة

Groq أفضل من OpenAI للاستخدام المجاني!

  • ✅ مجاني تماماً
  • ✅ أسرع بكثير
  • ✅ جودة ممتازة
  • ✅ لا يحتاج بطاقة ائتمان

ابدأ الآن واستمتع! 🚀

آخر تحديث: 11 أكتوبر 2025
الحالة: ✅ جاهز للاستخدام