🤖 كنق الاتمته - Chatbot Interface

نظام شات بوت ذكي متكامل مع واجهة عربية حديثة مبني على FastAPI و OpenAI GPT-4.

✨ المميزات

• 💬 واجهة شات حديثة وسريعة الاستجابة
• 🌓 دعم الوضع الليلي والنهاري
• 🔄 اتصال WebSocket في الوقت الفعلي
• 🤖 تكامل مع OpenAI GPT-4
• 📱 تصميم متجاوب يعمل على جميع الأجهزة
• 🎨 واجهة عربية بالكامل مع دعم RTL
• ⚡ أداء عالي مع FastAPI

📋 المتطلبات

• Python 3.11+
• OpenAI API Key
• المكتبات المذكورة في requirements.txt

🚀 التثبيت والتشغيل

1. تثبيت المكتبات

pip install -r requirements.txt

2. تثبيت Playwright (مطلوب)

playwright install

3. إعداد ملف البيئة

انسخ ملف .env.example إلى .env وأضف مفتاح OpenAI API الخاص بك:

cp .env.example .env

ثم عدّل ملف .env:

OPENAI_API_KEY=your_actual_api_key_here

4. تشغيل التطبيق

python -m app.main

أو باستخدام uvicorn مباشرة:

uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

5. فتح المتصفح

افتح المتصفح على العنوان:

http://localhost:8000

📁 بنية المشروع

Moj-Agentic-AI/
├── app/
│   ├── __init__.py
│   ├── main.py                 # FastAPI application
│   ├── core/
│   │   ├── __init__.py
│   │   └── config.py           # Configuration settings
│   └── services/
│       ├── __init__.py
│       └── ai_service.py       # OpenAI integration
├── templates/
│   └── chat.html               # Chat interface
├── static/                     # Static files (if needed)
├── requirements.txt            # Python dependencies
├── .env.example               # Environment variables template
├── .env                       # Your actual environment variables (not in git)
└── README.md                  # This file

🔧 التكوين

يمكنك تعديل الإعدادات في ملف .env:

المتغير	الوصف	القيمة الافتراضية
OPENAI_API_KEY	مفتاح OpenAI API	مطلوب
OPENAI_MODEL	نموذج GPT المستخدم	gpt-4
OPENAI_MAX_TOKENS	الحد الأقصى للتوكنز	2000
OPENAI_TEMPERATURE	درجة الإبداع	0.7
HOST	عنوان الخادم	0.0.0.0
PORT	منفذ الخادم	8000
DEBUG	وضع التطوير	True

🎯 الاستخدام

1. بدء محادثة جديدة: اضغط على زر ➕ في الأعلى
2. كتابة رسالة: اكتب رسالتك في صندوق الإدخال بالأسفل
3. إرسال: اضغط Enter أو زر الإرسال ⬆️
4. تبديل المظهر: اضغط على زر 🌙 في الشريط الجانبي
5. نسخ الكود: اضغط على زر النسخ في أي كتلة كود

🔌 API Endpoints

WebSocket

• ws://localhost:8000/ws/chat - اتصال WebSocket للشات

HTTP

• GET / - واجهة الشات
• GET /health - فحص صحة الخادم

🛠️ التطوير

إضافة ميزات جديدة

1. إضافة خدمة جديدة: أنشئ ملف في app/services/
2. إضافة endpoint جديد: عدّل app/main.py
3. تعديل الواجهة: عدّل templates/chat.html

تشغيل في وضع التطوير

uvicorn app.main:app --reload

📦 قواعد البيانات (اختياري)

المشروع يدعم:

• PostgreSQL: لتخزين المحادثات والمستخدمين
• MongoDB: لتخزين البيانات غير المهيكلة
• Redis: للتخزين المؤقت والجلسات

قم بتفعيلها من خلال إضافة بيانات الاتصال في ملف .env.

🔐 الأمان

• ⚠️ لا تشارك ملف .env أبداً
• ⚠️ لا ترفع مفتاح API إلى GitHub
• ✅ استخدم .gitignore لحماية الملفات الحساسة
• ✅ استخدم HTTPS في الإنتاج

🐛 حل المشاكل

المشكلة: لا يعمل الشات بوت

الحل: تأكد من:

1. إضافة OPENAI_API_KEY في ملف .env
2. تشغيل الخادم بنجاح
3. فتح المتصفح على http://localhost:8000

المشكلة: خطأ في الاتصال بـ WebSocket

الحل:

1. تأكد من تشغيل الخادم
2. افحص console المتصفح للأخطاء
3. تأكد من عدم حظر المنفذ 8000

المشكلة: خطأ في تثبيت المكتبات

الحل:

pip install --upgrade pip
pip install -r requirements.txt --no-cache-dir

📝 الترخيص

هذا المشروع مفتوح المصدر.

🤝 المساهمة

المساهمات مرحب بها! يرجى:

1. عمل Fork للمشروع
2. إنشاء branch جديد للميزة
3. عمل commit للتغييرات
4. إرسال Pull Request

📧 الدعم

للمساعدة والدعم، يرجى فتح Issue في GitHub.

---

صُنع بـ ❤️ في السعودية