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