Upload 9 files

.env.example

@@ -0,0 +1,13 @@
+# Environment Variables for CMA Chatbot
+
+# Google Gemini API Key (required for AI functionality)
+GEMINI_API_KEY=your_google_gemini_api_key_here
+
+# Alternative name for the API key (Hugging Face Spaces compatibility)
+GOOGLE_API_KEY=your_google_gemini_api_key_here
+
+# Instructions:
+# 1. Copy this file to .env
+# 2. Replace 'your_google_gemini_api_key_here' with your actual API key
+# 3. Get your API key from: https://makersuite.google.com/app/apikey
+# 4. For Hugging Face Spaces, add the key as a secret in your Space settings

.gitignore

@@ -0,0 +1,64 @@
+# Environment variables
+.env
+.env.local
+.env.production
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Temporary files
+*.tmp
+*.temp
+temp/
+tmp/
+
+# Gradio
+gradio_cached_examples/
+flagged/

DEPLOYMENT.md

@@ -0,0 +1,154 @@
+# 🚀 دليل النشر على Hugging Face Spaces
+
+هذا الدليل يوضح كيفية نشر مستشار هيئة أسواق المال على Hugging Face Spaces للحصول على رابط دائم ومجاني.
+
+## 📋 المتطلبات المسبقة
+
+1. **حساب Hugging Face**: إنشاء حساب مجاني على [huggingface.co](https://huggingface.co)
+2. **Google Gemini API Key**: الحصول على مفتاح API من [Google AI Studio](https://makersuite.google.com/app/apikey)
+
+## 🔧 خطوات النشر
+
+### الطريقة الأولى: الرفع المباشر (الأسهل)
+
+1. **إنشاء Space جديد**
+   - اذهب إلى [huggingface.co/new-space](https://huggingface.co/new-space)
+   - اختر اسماً للمشروع (مثل: `cma-arabic-chatbot`)
+   - اختر `Gradio` كـ SDK
+   - اختر `Public` للوصول العام
+
+2. **رفع الملفات**
+   - ارفع جميع الملفات من هذا المجلد:
+     - `app.py` (الملف الرئيسي)
+     - `requirements.txt`
+     - `README.md`
+     - `LICENSE`
+   - يمكنك سحب وإفلات الملفات مباشرة في واجهة الويب
+
+3. **إعداد المتغيرات السرية**
+   - اذهب إلى إعدادات Space
+   - أضف متغير سري جديد:
+     - **Name**: `GEMINI_API_KEY`
+     - **Value**: مفتاح Google Gemini API الخاص بك
+
+4. **تشغيل التطبيق**
+   - سيتم بناء وتشغيل التطبيق تلقائياً
+   - ستحصل على رابط دائم مثل: `https://huggingface.co/spaces/username/cma-arabic-chatbot`
+
+### الطريقة الثانية: استخدام Git
+
+```bash
+# 1. استنساخ المستودع
+git clone https://huggingface.co/spaces/username/cma-arabic-chatbot
+cd cma-arabic-chatbot
+
+# 2. نسخ الملفات
+cp -r /path/to/cma-chatbot-hf/* .
+
+# 3. رفع التغييرات
+git add .
+git commit -m "Initial commit: CMA Arabic Chatbot"
+git push
+```
+
+## ⚙️ إعدادات متقدمة
+
+### تخصيص المظهر
+يمكنك تعديل ملف `app.py` لتخصيص:
+- الألوان والتصميم
+- النصوص والرسائل
+- الأمثلة المعروضة
+
+### إضافة المزيد من المعرفة
+لإضافة المزيد من الأسئلة والأجوبة:
+1. عدّل قائمة `_load_default_knowledge()` في `app.py`
+2. أضف الأسئلة والأجوبة الجديدة
+3. احفظ وارفع التغييرات
+
+### تحسين الأداء
+- استخدم نموذج AI أسرع إذا لزم الأمر
+- قلل من حجم قاعدة المعرفة للاستجابة الأسرع
+- أضف تخزين مؤقت للاستعلامات المتكررة
+
+## 🔒 الأمان والخصوصية
+
+### حماية مفتاح API
+- **لا تضع** مفتاح API في الكود مباشرة
+- استخدم **Secrets** في إعدادات Hugging Face Space
+- تأكد من أن `.env` مدرج في `.gitignore`
+
+### خصوصية البيانات
+- لا يتم حفظ محادثات المستخدمين
+- جميع المعالجات تتم في الوقت الفعلي
+- لا يتم مشاركة البيانات مع أطراف ثالثة
+
+## 🐛 استكشاف الأخطاء
+
+### مشاكل شائعة وحلولها
+
+**1. خطأ في مفتاح API**
+```
+Error: No API key found
+```
+**الحل**: تأكد من إضافة `GEMINI_API_KEY` في إعدادات Secrets
+
+**2. خطأ في التبعيات**
+```
+ModuleNotFoundError: No module named 'gradio'
+```
+**الحل**: تأكد من أن `requirements.txt` يحتوي على جميع المكتبات المطلوبة
+
+**3. مشاكل في العرض العربي**
+```
+Arabic text not displaying correctly
+```
+**الحل**: تأكد من أن المتصفح يدعم UTF-8 وأن CSS يحتوي على `direction: rtl`
+
+**4. بطء في الاستجابة**
+```
+Timeout errors or slow responses
+```
+**الحل**: 
+- تحقق من حالة Google Gemini API
+- قلل من حجم السياق المرسل للنموذج
+- أضف معالجة أخطاء أفضل
+
+## 📊 مراقبة الأداء
+
+### مقاييس مهمة
+- **وقت الاستجابة**: يجب أن يكون أقل من 10 ثوانٍ
+- **معدل النجاح**: يجب أن يكون أعلى من 95%
+- **رضا المستخدمين**: من خلال التقييمات والتعليقات
+
+### تحسين الأداء
+- راقب استخدام API quota
+- حسّن صياغة الأسئلة للنموذج
+- أضف ردود سريعة للأسئلة الشائعة
+
+## 🔄 التحديثات والصيانة
+
+### تحديث المحتوى
+1. عدّل قاعدة المعرفة في `app.py`
+2. اختبر التغييرات محلياً
+3. ارفع التحديثات إلى Hugging Face
+
+### تحديث التقنيات
+- راقب تحديثات Gradio
+- حدّث مكتبات Python في `requirements.txt`
+- اختبر التوافق مع إصدارات جديدة
+
+## 📞 الدعم
+
+### للمساعدة التقنية
+- [Hugging Face Community](https://huggingface.co/join/discord)
+- [Gradio Documentation](https://gradio.app/docs/)
+- [Google AI Documentation](https://ai.google.dev/docs)
+
+### للمساهمة في المشروع
+- افتح Issue للإبلاغ عن مشاكل
+- اقترح تحسينات عبر Pull Requests
+- شارك تجربتك مع المجتمع
+
+---
+
+**نصيحة**: احتفظ بنسخة احتياطية من مفتاح API وإعدادات المشروع في مكان آمن!

HUGGINGFACE_DEPLOYMENT_GUIDE.md

@@ -0,0 +1,202 @@
+# 🚀 دليل النشر الكامل على Hugging Face Spaces
+
+## 📋 ما تحتاجه للبدء
+
+✅ **حساب Hugging Face** (مجاني)  
+✅ **OpenAI API Key** (لديك بالفعل)  
+✅ **ملفات المشروع** (موجودة في هذا المجلد)
+
+---
+
+## 🔧 الخطوة 1: إعداد حساب Hugging Face
+
+### 1.1 إنشاء الحساب
+1. اذهب إلى [huggingface.co](https://huggingface.co)
+2. اضغط "Sign Up" وأنشئ حساباً مجانياً
+3. تأكد من تفعيل البريد الإلكتروني
+
+### 1.2 إنشاء Space جديد
+1. اذهب إلى [huggingface.co/new-space](https://huggingface.co/new-space)
+2. املأ البيانات:
+   - **Space name**: `cma-arabic-chatbot` (أو أي اسم تريده)
+   - **License**: MIT
+   - **SDK**: اختر `Gradio`
+   - **Visibility**: اختر `Public`
+3. اضغط "Create Space"
+
+---
+
+## 📁 الخطوة 2: رفع الملفات
+
+### 2.1 الملفات المطلوبة (من هذا المجلد)
+ارفع هذه الملفات بالترتيب:
+
+1. **`app.py`** - الملف الرئيسي للتطبيق
+2. **`requirements.txt`** - المكتبات المطلوبة
+3. **`README.md`** - وصف المشروع
+
+### 2.2 طريقة الرفع
+**الطريقة الأسهل - السحب والإفلات:**
+1. افتح صفحة Space الخاص بك
+2. اسحب الملفات من مجلد `cma-chatbot-hf` وأفلتها في المتصفح
+3. أضف رسالة commit مثل: "Initial upload of CMA chatbot"
+4. اضغط "Commit changes to main"
+
+---
+
+## 🔑 الخطوة 3: إعداد OpenAI API Key
+
+### 3.1 إضافة المفتاح كـ Secret
+1. في صفحة Space، اضغط "Settings" (أعلى اليمين)
+2. اذهب إلى قسم "Repository secrets"
+3. اضغط "Add a new secret"
+4. املأ البيانات:
+   - **Name**: `OPENAI_API_KEY`
+   - **Value**: الصق مفتاح OpenAI API الخاص بك
+5. اضغط "Add secret"
+
+### 3.2 تأكيد الإعداد
+- تأكد من أن اسم المتغير هو `OPENAI_API_KEY` بالضبط
+- لا تضع مسافات أو أحرف إضافية
+- المفتاح يجب أن يبدأ بـ `sk-`
+
+---
+
+## ⚙️ الخطوة 4: تعديل الكود للعمل مع OpenAI
+
+### 4.1 تحديث app.py
+الكود الحالي يستخدم Google Gemini، نحتاج لتعديله لـ OpenAI:
+
+```python
+# استبدل هذا الجزء في app.py
+import openai
+import os
+
+class CMAGradioBot:
+    def __init__(self):
+        self.setup_openai()
+        self.knowledge_base = CMAKnowledgeBase()
+        
+    def setup_openai(self):
+        """Configure OpenAI API"""
+        api_key = os.getenv('OPENAI_API_KEY')
+        if not api_key:
+            self.client = None
+            print("⚠️ No OpenAI API key found. Using fallback responses.")
+            return
+        
+        try:
+            openai.api_key = api_key
+            self.client = openai
+            print("✅ OpenAI API configured successfully")
+        except Exception as e:
+            self.client = None
+            print(f"⚠️ Failed to configure OpenAI: {e}")
+```
+
+### 4.2 تحديث requirements.txt
+```txt
+gradio>=4.0.0
+openai>=1.0.0
+python-dotenv>=1.0.0
+```
+
+---
+
+## 🔄 الخطوة 5: تشغيل التطبيق
+
+### 5.1 انتظار البناء
+- بعد رفع الملفات، سيبدأ Hugging Face في بناء التطبيق
+- ستظهر رسائل البناء في الأسفل
+- انتظر حتى ترى "Running" باللون الأخضر
+
+### 5.2 اختبار التطبيق
+1. ستحصل على رابط مثل: `https://huggingface.co/spaces/username/cma-arabic-chatbot`
+2. اختبر بسؤال بسيط مثل: "ما هي المدة القانونية للاحتفاظ ببيانات KYC؟"
+3. تأكد من أن الإجابة تظهر بالعربية
+
+---
+
+## 🛠️ استكشاف الأخطاء الشائعة
+
+### ❌ خطأ: "No API key found"
+**الحل:**
+1. تأكد من إضافة `OPENAI_API_KEY` في Secrets
+2. تأكد من كتابة الاسم بالضبط
+3. أعد تشغيل Space (Settings → Restart this Space)
+
+### ❌ خطأ: "Module not found"
+**الحل:**
+1. تأكد من رفع `requirements.txt`
+2. تأكد من أن المحتوى صحيح
+3. انتظر اكتمال البناء
+
+### ❌ خطأ: "Build failed"
+**الحل:**
+1. تحقق من رسائل الخطأ في logs
+2. تأكد من أن `app.py` لا يحتوي على أخطاء syntax
+3. تأكد من أن جميع imports موجودة في requirements.txt
+
+### ❌ النص العربي لا يظهر بشكل صحيح
+**الحل:**
+1. تأكد من أن المتصفح يدعم UTF-8
+2. تحقق من CSS في app.py (direction: rtl)
+3. جرب متصفح مختلف
+
+---
+
+## 📊 التحقق من نجاح النشر
+
+### ✅ علامات النجاح:
+- [ ] التطبيق يعمل بدون أخطاء
+- [ ] النص العربي يظهر بشكل صحيح (من اليمين لليسار)
+- [ ] الأسئلة تحصل على إجابات
+- [ ] الرابط يعمل من أجهزة مختلفة
+- [ ] لا توجد رسائل خطأ في console
+
+### 🎯 اختبار سريع:
+جرب هذه الأسئلة:
+1. "ما هي المدة القانونية للاحتفاظ ببيانات KYC؟"
+2. "هل هناك قيود على تداولات الموظفين؟"
+3. "ما هي متطلبات الإفصاح؟" (يجب أن يقول لا توجد معلومات)
+
+---
+
+## 🔄 تحديث التطبيق لاحقاً
+
+### لإضافة المزيد من الأسئلة:
+1. عدّل قائمة `_load_default_knowledge()` في `app.py`
+2. أضف الأسئلة والأجوبة الجديدة
+3. ارفع الملف المحدث
+4. سيتم إعادة بناء التطبيق تلقائياً
+
+### لتحديث التصميم:
+1. عدّل CSS في `app.py`
+2. غيّر الألوان أو التخطيط
+3. ارفع التحديث
+
+---
+
+## 📞 الحصول على المساعدة
+
+### إذا واجهت مشاكل:
+1. **Hugging Face Community**: [hf.co/join/discord](https://hf.co/join/discord)
+2. **Gradio Docs**: [gradio.app/docs](https://gradio.app/docs)
+3. **OpenAI Docs**: [platform.openai.com/docs](https://platform.openai.com/docs)
+
+### معلومات مفيدة للدعم:
+- رابط Space الخاص بك
+- رسائل الخطأ (إن وجدت)
+- متصفح ونظام التشغيل المستخدم
+
+---
+
+## 🎉 تهانينا!
+
+بمجرد اكتمال هذه الخطوات، ستحصل على:
+- ✅ **رابط دائم** لتطبيق CMA chatbot
+- ✅ **استضافة مجانية** على Hugging Face
+- ✅ **واجهة احترافية** باللغة العربية
+- ✅ **إمكانية المشاركة** مع الآخرين
+
+**رابطك سيكون:** `https://huggingface.co/spaces/username/cma-arabic-chatbot`

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 CMA Arabic Document Chatbot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

QUICK_START.md

@@ -0,0 +1,68 @@
+# ⚡ دليل البدء السريع - 5 دقائق للنشر
+
+## 🎯 الهدف
+نشر مستشار هيئة أسواق المال على Hugging Face Spaces في 5 دقائق فقط!
+
+## 📝 الخطوات السريعة
+
+### 1️⃣ إنشاء حساب (دقيقة واحدة)
+- اذهب إلى [huggingface.co](https://huggingface.co) وأنشئ حساباً مجانياً
+
+### 2️⃣ الحصول على API Key (دقيقتان)
+- اذهب إلى [Google AI Studio](https://makersuite.google.com/app/apikey)
+- اضغط "Create API Key"
+- انسخ المفتاح واحتفظ به
+
+### 3️⃣ إنشاء Space (دقيقة واحدة)
+- اذهب إلى [huggingface.co/new-space](https://huggingface.co/new-space)
+- **Space name**: `cma-arabic-chatbot` (أو أي اسم تريده)
+- **SDK**: اختر `Gradio`
+- **Visibility**: اختر `Public`
+- اضغط "Create Space"
+
+### 4️⃣ رفع الملفات (دقيقة واحدة)
+سحب وإفلات هذه الملفات في Space:
+- ✅ `app.py`
+- ✅ `requirements.txt` 
+- ✅ `README.md`
+
+### 5️⃣ إضافة API Key (30 ثانية)
+- في صفحة Space، اضغط "Settings"
+- اذهب إلى "Repository secrets"
+- اضغط "Add a new secret"
+- **Name**: `GEMINI_API_KEY`
+- **Value**: الصق مفتاح Google API
+- اضغط "Add secret"
+
+## 🎉 انتهيت!
+
+سيتم بناء التطبيق تلقائياً وستحصل على رابط مثل:
+`https://huggingface.co/spaces/username/cma-arabic-chatbot`
+
+## 🔧 إذا واجهت مشاكل
+
+### المشكلة: "No API key found"
+**الحل**: تأكد من إضافة `GEMINI_API_KEY` في Secrets
+
+### المشكلة: "Build failed"
+**الحل**: تأكد من رفع `requirements.txt`
+
+### المشكلة: "Arabic text not showing"
+**الحل**: انتظر دقيقتين لاكتمال البناء
+
+## 📱 اختبار سريع
+
+جرب هذه الأسئلة:
+- ما هي المدة القانونية للاحتفاظ ببيانات KYC؟
+- هل هناك قيود على تداولات الموظفين؟
+
+## 🚀 مشاركة التطبيق
+
+بمجرد أن يعمل التطبيق:
+- انسخ الرابط وشاركه
+- أضفه إلى موقعك الإلكتروني
+- استخدمه في العروض التقديمية
+
+---
+
+**تهانينا! 🎊 لديك الآن مستشار CMA يعمل على الإنترنت مجاناً!**

README.md

@@ -1,14 +1,119 @@
 ---
-title: CMP AI
-emoji: 😻
+title: CMA Arabic Document Chatbot
+emoji: 🤖
 colorFrom: blue
-colorTo: red
+colorTo: purple
 sdk: gradio
-sdk_version: 5.47.0
+sdk_version: 4.44.0
 app_file: app.py
 pinned: false
-license: apache-2.0
-short_description: cma-arabic-chatbot
+license: mit
+language:
+- ar
+tags:
+- chatbot
+- arabic
+- legal
+- finance
+- cma
+- kuwait
+- regulations
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🤖 مستشار هيئة أسواق المال الكويتية
+
+## نظرة عامة
+
+مساعد ذكي متخصص في قوانين ولوائح هيئة أسواق المال الكويتية (CMA). يستخدم الذكاء الاصطناعي وقاعدة معرفة متخصصة لتقديم إجابات دقيقة ومفيدة حول الاستفسارات التنظيمية والقانونية.
+
+## المميزات الرئيسية
+
+### 🎯 **التخصص**
+- متخصص في قوانين هيئة أسواق المال الكويتية
+- يغطي مواضيع KYC، التفويض القانوني، قيود الموظفين، وإدارة الاستثمار
+- معلومات محدثة ودقيقة من المصادر الرسمية
+
+### 🤖 **التقنية المتقدمة**
+- مدعوم بنموذج Google Gemini-1.5-Flash للذكاء الاصطناعي
+- قاعدة معرفة متخصصة ومنظمة
+- معالجة طبيعية للغة العربية
+
+### 🎨 **واجهة مستخدم متقدمة**
+- تصميم يدعم اللغة العربية (RTL)
+- واجهة تفاعلية وسهلة الاستخدام
+- أمثلة توضيحية ومساعدة مدمجة
+
+## الأسئلة المدعومة
+
+يمكن للمستشار الإجابة على أسئلة متنوعة مثل:
+
+### 📊 **بيانات العملاء**
+- ما هي المدة القانونية للاحتفاظ ببيانات اعرف عميلك (KYC)؟
+- ما هي متطلبات تحديث بيانات العملاء؟
+
+### 📝 **التفويض القانوني**
+- ما هي شروط التفويض القانوني لفتح الحسابات الاستثمارية؟
+- هل يجوز أن يكون التفويض إلكترونياً؟
+
+### 👥 **قيود الموظفين**
+- هل هناك قيود على تداولات موظفي الشركات المرخصة؟
+- ما هي إجراءات الإبلاغ عن تداولات الموظفين؟
+
+### 💼 **إدارة الاستثمار**
+- هل يجوز التواصل مع العملاء قبل الحصول على ترخيص التسويق؟
+- ما هي التزامات حماية أموال العملاء؟
+
+## كيفية الاستخدام
+
+1. **اكتب سؤالك** في مربع النص
+2. **اضغط إرسال** أو اضغط Enter
+3. **احصل على إجابة** مفصلة ودقيقة
+4. **استمر في المحادثة** لمزيد من التوضيح
+
+## التقنيات المستخدمة
+
+- **Gradio**: لبناء واجهة الويب التفاعلية
+- **Google Gemini AI**: لمعالجة الاستفسارات وتوليد الإجابات
+- **Python**: لغة البرمجة الأساسية
+- **HTML/CSS**: لتخصيص التصميم والدعم العربي
+
+## الإعداد والتشغيل
+
+### متطلبات النظام
+```bash
+pip install -r requirements.txt
+```
+
+### متغيرات البيئة
+```bash
+GEMINI_API_KEY=your_google_gemini_api_key
+```
+
+### تشغيل التطبيق
+```bash
+python app.py
+```
+
+## ملاحظات مهمة
+
+⚠️ **تنبيه**: هذا المستشار يقدم معلومات عامة للمساعدة والتوجيه. للحصول على استشارة قانونية رسمية أو معلومات محدثة، يرجى مراجعة الموقع الرسمي لهيئة أسواق المال الكويتية.
+
+## الترخيص
+
+هذا المشروع مرخص تحت رخصة MIT - راجع ملف [LICENSE](LICENSE) للتفاصيل.
+
+## المساهمة
+
+نرحب بالمساهمات لتحسين المستشار وإضافة المزيد من المعلومات. يرجى:
+
+1. عمل Fork للمشروع
+2. إنشاء فرع جديد للميزة
+3. تقديم Pull Request
+
+## الدعم
+
+للأسئلة أو المشاكل التقنية، يرجى فتح Issue في المستودع.
+
+---
+
+**تم تطوير هذا المستشار لتسهيل الوصول إلى المعلومات التنظيمية والقانونية لهيئة أسواق المال الكويتية**

app.py

@@ -0,0 +1,333 @@
+#!/usr/bin/env python3
+"""
+CMA Arabic Document Chatbot for Hugging Face Spaces - OpenAI Version
+Specialized chatbot for Kuwait Capital Markets Authority regulations
+"""
+
+import os
+import json
+import gradio as gr
+import openai
+from typing import List, Dict, Any, Optional
+
+class CMAKnowledgeBase:
+    """Knowledge base for CMA regulations and Q&A"""
+    
+    def __init__(self):
+        self.qa_data = self._load_default_knowledge()
+    
+    def _load_default_knowledge(self) -> List[Dict[str, Any]]:
+        """Load default CMA knowledge base"""
+        return [
+            {
+                "question": "ما هي المدة القانونية التي يجب أن يحتفظ فيها الشخص المرخص له ببيانات اعرف عميلك (KYC) بعد انتهاء العلاقة مع العميل؟",
+                "answer": "خمس سنوات.",
+                "category": "Capital Markets"
+            },
+            {
+                "question": "ما هي الشروط التي يجب أن تتوافر في التفويض القانوني الذي يسمح لشخص بفتح وتشغيل حساب استثماري نيابة عن عميل؟ وهل يجوز أن يكون التفويض إلكترونياً؟",
+                "answer": "• يجب أن يكون التفويض صادرًا من كاتب عدل أو موثق معتمد من وزارة العدل.\n• يجب أن يتضمن نصا صريحًا بالصلاحيات المفوضة مثل فتح الحساب، تشغيله، إجراء الحوالات، أو بيع وشراء الأوراق المالية.\n• لا يعتد بالتفويض الإلكتروني إلا إذا كان موثقًا ومعتمدًا وفق قانون المعاملات الإلكترونية.",
+                "category": "Capital Markets"
+            },
+            {
+                "question": "هل هناك قيود مفروضة على موظفي الشخص المرخص له من قبل هيئة أسواق المال بالنسبة لتداولاتهم؟",
+                "answer": "يتعين على موظفي الشخص المرخص له الالتزام بالتعليمات والقيود المفروضة عليهم من قبل الهيئة، حيث يتعين إبلاغ مسؤول المطابقة والالتزام - على الفور - بأي صفقة (بيع أو شراء أوراق مالية محلية) يجريها عن نفسه أو بالإنابة عن أحد أقربائه أو عن شركة تابعة له أو لأحد أقربائه.",
+                "category": "Capital Markets"
+            },
+            {
+                "question": "هل يجوز للشخص المرخص له بمزاولة نشاط مدير استثمار جماعي أن يتواصل مع بعض العملاء لمعرفة رأيهم بشأن الاستثمار في صندوق يرغب بتسويقه مستقبلاً؟ وذلك قبل حصوله على ترخيص تسويق الصندوق من الهيئة؟",
+                "answer": "يجوز للهيئة – بناء على طلب مقدم - أن تسمح للمسوق خلال فترة استكمال متطلبات الهيئة التواصل مع العملاء المحترفين المحتملين لبحث رغبتهم بالاستثمار في الصندوق المزمع تسويقه دون الإعلان في وسائل الاعلام، وأن لا يتم تقاضي أي مبالغ نقدية أو غير نقدية أو الحصول على التزام نهائي من العملاء بالاشتراك في الصندوق قبل الحصول على ترخيص التسويق من الهيئة.",
+                "category": "Capital Markets"
+            },
+            {
+                "question": "ما هي التزامات الشخص المرخص له تجاه حماية أموال العملاء؟",
+                "answer": "يجب على الشخص المرخص له الالتزام بقوانين اعرف عميلك (KYC) والاحتفاظ ببيانات العملاء لمدة خمس سنوات، والتأكد من صحة التفويضات القانونية، والإبلاغ الفوري عن تعاملات الموظفين لمنع تضارب المصالح، والامتثال لقوانين هيئة أسواق المال لضمان حماية أموال العملاء من خلال الشفافية والنزاهة في التعاملات المالية.",
+                "category": "Capital Markets"
+            }
+        ]
+    
+    def get_cma_context(self) -> List[Dict[str, str]]:
+        """Get CMA-specific context for AI prompts"""
+        return [
+            {
+                'question': item['question'],
+                'answer': item['answer']
+            }
+            for item in self.qa_data
+            if item.get('category') == 'Capital Markets'
+        ]
+
+class CMAGradioBot:
+    """Main chatbot class for CMA regulations using OpenAI"""
+    
+    def __init__(self):
+        self.knowledge_base = CMAKnowledgeBase()
+        self.setup_openai()
+        
+    def setup_openai(self):
+        """Configure OpenAI API"""
+        # Try to get API key from environment or Hugging Face secrets
+        api_key = os.getenv('OPENAI_API_KEY')
+        
+        if not api_key:
+            # For demo purposes, we'll handle this gracefully
+            self.client = None
+            print("⚠️ No OpenAI API key found. Using fallback responses.")
+            return
+        
+        try:
+            # Set up OpenAI client
+            openai.api_key = api_key
+            self.client = openai
+            print("✅ OpenAI API configured successfully")
+        except Exception as e:
+            self.client = None
+            print(f"⚠️ Failed to configure OpenAI: {e}")
+    
+    def generate_response(self, question: str) -> str:
+        """Generate response using OpenAI with CMA context"""
+        
+        # If no AI model available, use fallback
+        if not self.client:
+            return self._fallback_response(question)
+        
+        try:
+            # Get CMA context
+            cma_context = self.knowledge_base.get_cma_context()
+            
+            # Build context prompt
+            context_prompt = """أنت مستشار متخصص في قوانين هيئة أسواق المال الكويتية (CMA). 
+استخدم المعلومات التالية للإجابة على الأسئلة بدقة ومهنية.
+
+المعلومات المرجعية من قاعدة المعرفة:
+"""
+            
+            # Add context from knowledge base
+            for item in cma_context:
+                if item['question'] and item['answer']:
+                    context_prompt += f"\nسؤال: {item['question']}\nجواب: {item['answer']}\n"
+            
+            # Add current question
+            context_prompt += f"""
+الآن أجب على السؤال التالي بناءً على المعلومات المتوفرة:
+
+سؤال: {question}
+
+إرشادات الإجابة:
+- إذا كانت المعلومات متوفرة في قاعدة المعرفة، قدم إجابة دقيقة ومفصلة
+- إذا لم تكن المعلومات متوفرة، اعترف بذلك بصراحة وأرشد المستخدم للمصادر الرسمية
+- استخدم اللغة العربية الفصحى المهنية
+- كن مختصراً ومفيداً ودقيقاً
+
+جواب:"""
+            
+            # Generate response using OpenAI
+            response = self.client.ChatCompletion.create(
+                model="gpt-3.5-turbo",
+                messages=[
+                    {"role": "system", "content": "أنت مستشار متخصص في قوانين هيئة أسواق المال الكويتية. أجب باللغة العربية فقط."},
+                    {"role": "user", "content": context_prompt}
+                ],
+                max_tokens=500,
+                temperature=0.3
+            )
+            
+            return response.choices[0].message.content.strip()
+            
+        except Exception as e:
+            error_msg = f"عذراً، حدث خطأ في معالجة السؤال. يرجى المحاولة مرة أخرى أو التواصل مع هيئة أسواق المال مباشرة للحصول على معلومات رسمية."
+            print(f"Error generating response: {e}")
+            return error_msg
+    
+    def _fallback_response(self, question: str) -> str:
+        """Fallback response when AI model is not available"""
+        # Simple keyword matching for demo
+        question_lower = question.lower()
+        
+        if "kyc" in question_lower or "اعرف عميلك" in question:
+            return "بناءً على قوانين هيئة أسواق المال الكويتية، يجب الاحتفاظ ببيانات اعرف عميلك (KYC) لمدة خمس سنوات بعد انتهاء العلاقة مع العميل."
+        
+        elif "تفويض" in question or "حساب استثماري" in question:
+            return "يجب أن يكون التفويض القانوني صادراً من كاتب عدل أو موثق معتمد من وزارة العدل، ويتضمن نصاً صريحاً بالصلاحيات المفوضة. لا يُعتد بالتفويض الإلكتروني إلا إذا كان موثقاً ومعتمداً وفق قانون المعاملات الإلكترونية."
+        
+        elif "موظف" in question or "تداول" in question:
+            return "يتعين على موظفي الشخص المرخص له إبلاغ مسؤول المطابقة والالتزام على الفور بأي صفقة (بيع أو شراء أوراق مالية محلية) يجريها عن نفسه أو بالإنابة عن أحد أقربائه."
+        
+        else:
+            return "عذراً، لا تتوفر معلومات كافية في قاعدة المعرفة الحالية للإجابة على هذا السؤال. يرجى الرجوع إلى الموقع الرسمي لهيئة أسواق المال الكويتية أو التواصل معهم مباشرة للحصول على معلومات دقيقة ومحدثة."
+
+def create_gradio_interface():
+    """Create and configure Gradio interface"""
+    
+    # Initialize chatbot
+    bot = CMAGradioBot()
+    
+    def chat_response(message, history):
+        """Handle chat responses"""
+        if not message.strip():
+            return history, ""
+        
+        # Generate response
+        response = bot.generate_response(message)
+        
+        # Update history
+        if history is None:
+            history = []
+        
+        history.append([message, response])
+        return history, ""
+    
+    # Create Gradio interface with custom theme
+    with gr.Blocks(
+        title="مستشار هيئة أسواق المال الكويتية",
+        theme=gr.themes.Soft(
+            primary_hue="blue",
+            secondary_hue="gray",
+            neutral_hue="gray"
+        ),
+        css="""
+        .gradio-container {
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            direction: rtl;
+            text-align: right;
+        }
+        .chat-message {
+            text-align: right;
+            direction: rtl;
+        }
+        .message-wrap {
+            direction: rtl;
+        }
+        .message {
+            text-align: right;
+        }
+        """
+    ) as interface:
+        
+        # Header
+        gr.HTML("""
+        <div style="text-align: center; padding: 30px; background: linear-gradient(135deg, #1e3c72 0%, #2a5298 100%); color: white; border-radius: 15px; margin-bottom: 25px; box-shadow: 0 4px 15px rgba(0,0,0,0.1);">
+            <h1 style="margin: 0; font-size: 2.5rem; font-weight: bold;">🤖 مستشار هيئة أسواق المال الكويتية</h1>
+            <p style="margin: 15px 0 0 0; font-size: 1.2rem; opacity: 0.9;">مساعد ذكي متخصص في الاستشارات التنظيمية والقانونية</p>
+            <p style="margin: 10px 0 0 0; font-size: 1rem; opacity: 0.8;">مدعوم بالذكاء الاصطناعي وقاعدة معرفة متخصصة</p>
+        </div>
+        """)
+        
+        # Main chat interface
+        with gr.Row():
+            with gr.Column(scale=1):
+                chatbot = gr.Chatbot(
+                    label="💬 المحادثة مع المستشار",
+                    height=500,
+                    show_label=True,
+                    container=True,
+                    show_copy_button=True,
+                    type="tuples"
+                )
+                
+                with gr.Row():
+                    msg = gr.Textbox(
+                        label="✍️ اكتب سؤالك هنا",
+                        placeholder="مثال: ما هي المدة القانونية للاحتفاظ ببيانات KYC؟",
+                        lines=2,
+                        max_lines=5,
+                        show_label=True,
+                        container=True,
+                        scale=4
+                    )
+                    
+                    submit_btn = gr.Button(
+                        "📤 إرسال",
+                        variant="primary",
+                        scale=1,
+                        size="lg"
+                    )
+                
+                clear_btn = gr.Button(
+                    "🗑️ مسح المحادثة",
+                    variant="secondary",
+                    size="sm"
+                )
+        
+        # Example questions section
+        with gr.Accordion("📋 أمثلة على الأسئلة المتاحة", open=False):
+            gr.HTML("""
+            <div style="padding: 20px; background: #f8f9fa; border-radius: 10px; direction: rtl; text-align: right;">
+                <h3 style="color: #2c3e50; margin-bottom: 15px;">أسئلة يمكن للمستشار الإجابة عليها:</h3>
+                <div style="display: grid; gap: 10px;">
+                    <div style="padding: 10px; background: white; border-radius: 8px; border-right: 4px solid #007bff;">
+                        <strong>📊 بيانات العملاء:</strong> ما هي المدة القانونية للاحتفاظ ببيانات اعرف عميلك (KYC)؟
+                    </div>
+                    <div style="padding: 10px; background: white; border-radius: 8px; border-right: 4px solid #28a745;">
+                        <strong>📝 التفويض القانوني:</strong> ما هي شروط التفويض القانوني لفتح الحسابات الاستثمارية؟
+                    </div>
+                    <div style="padding: 10px; background: white; border-radius: 8px; border-right: 4px solid #ffc107;">
+                        <strong>👥 قيود الموظفين:</strong> هل هناك قيود على تداولات موظفي الشركات المرخصة؟
+                    </div>
+                    <div style="padding: 10px; background: white; border-radius: 8px; border-right: 4px solid #dc3545;">
+                        <strong>💼 إدارة الاستثمار:</strong> هل يجوز التواصل مع العملاء قبل الحصول على ترخيص التسويق؟
+                    </div>
+                </div>
+            </div>
+            """)
+        
+        # Information section
+        with gr.Accordion("ℹ️ معلومات مهمة", open=False):
+            gr.HTML("""
+            <div style="padding: 20px; background: #e3f2fd; border-radius: 10px; direction: rtl; text-align: right;">
+                <h3 style="color: #1565c0; margin-bottom: 15px;">🔍 حول هذا المستشار:</h3>
+                <ul style="line-height: 1.8; color: #424242;">
+                    <li><strong>التخصص:</strong> قوانين ولوائح هيئة أسواق المال الكويتية (CMA)</li>
+                    <li><strong>التقنية:</strong> مدعوم بالذكاء الاصطناعي (OpenAI GPT) وقاعدة معرفة متخصصة</li>
+                    <li><strong>اللغة:</strong> العربية مع دعم كامل للنصوص من اليمين إلى اليسار</li>
+                    <li><strong>الدقة:</strong> يعتمد على مصادر رسمية ويوضح حدود المعرفة المتاحة</li>
+                </ul>
+                
+                <div style="margin-top: 20px; padding: 15px; background: #fff3cd; border-radius: 8px; border-right: 4px solid #ffc107;">
+                    <h4 style="color: #856404; margin: 0 0 10px 0;">⚠️ تنبيه مهم:</h4>
+                    <p style="margin: 0; color: #856404;">
+                        هذا المستشار يقدم معلومات عامة للمساعدة والتوجيه. للحصول على استشارة قانونية رسمية أو معلومات محدثة، 
+                        يرجى مراجعة الموقع الرسمي لهيئة أسواق المال الكويتية أو التواصل معهم مباشرة.
+                    </p>
+                </div>
+            </div>
+            """)
+        
+        # Footer
+        gr.HTML("""
+        <div style="text-align: center; margin-top: 30px; padding: 20px; background: #f5f5f5; border-radius: 10px; color: #666;">
+            <p style="margin: 0; font-size: 0.9em;">
+                🏛️ <strong>هيئة أسواق المال الكويتية</strong> | 
+                🤖 <strong>مدعوم بالذكاء الاصطناعي</strong> | 
+                🔒 <strong>معلومات موثوقة ومتخصصة</strong>
+            </p>
+            <p style="margin: 10px 0 0 0; font-size: 0.8em; opacity: 0.8;">
+                تم تطوير هذا المستشار لتسهيل الوصول إلى المعلومات التنظيمية والقانونية
+            </p>
+        </div>
+        """)
+        
+        # Event handlers
+        msg.submit(chat_response, [msg, chatbot], [chatbot, msg])
+        submit_btn.click(chat_response, [msg, chatbot], [chatbot, msg])
+        clear_btn.click(lambda: ([], ""), None, [chatbot, msg])
+        
+        # Clear message box after submit
+        msg.submit(lambda: "", None, msg)
+        submit_btn.click(lambda: "", None, msg)
+    
+    return interface
+
+# Launch the application
+if __name__ == "__main__":
+    print("🚀 Starting CMA Arabic Document Chatbot...")
+    print("📋 Specialized in Kuwait Capital Markets Authority regulations")
+    print("🔧 Using OpenAI GPT for AI processing")
+    
+    interface = create_gradio_interface()
+    interface.launch(
+        share=False,  # Hugging Face Spaces handles sharing
+        server_name="0.0.0.0",
+        server_port=7860,
+        show_error=True
+    )

requirements.txt

@@ -0,0 +1,3 @@
+gradio>=4.0.0
+openai>=1.0.0
+python-dotenv>=1.0.0