# ⚡ دليل البدء السريع - 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 يعمل على الإنترنت مجاناً!**