QUICK_START.md

⚡ دليل البدء السريع - 5 دقائق للنشر

🎯 الهدف

نشر مستشار هيئة أسواق المال على Hugging Face Spaces في 5 دقائق فقط!

📝 الخطوات السريعة

1️⃣ إنشاء حساب (دقيقة واحدة)

• اذهب إلى huggingface.co وأنشئ حساباً مجانياً

2️⃣ الحصول على API Key (دقيقتان)

• اذهب إلى Google AI Studio
• اضغط "Create API Key"
• انسخ المفتاح واحتفظ به

3️⃣ إنشاء Space (دقيقة واحدة)

• اذهب إلى 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 يعمل على الإنترنت مجاناً!