| # 🚀 خطوات رفع GeoGuard على HuggingFace Spaces |
|
|
| ## 📁 الملفات المطلوبة |
| ``` |
| geoguard/ |
| ├── app.py ← الكود الرئيسي |
| ├── requirements.txt ← المكتبات |
| └── README.md ← وصف المشروع |
| ``` |
|
|
| --- |
|
|
| ## الخطوة 1️⃣ – إنشاء حساب على HuggingFace |
| 1. افتح: https://huggingface.co/join |
| 2. سجّل بالإيميل |
| 3. فعّل الحساب من الإيميل |
|
|
| --- |
|
|
| ## الخطوة 2️⃣ – إنشاء Space جديد |
| 1. افتح: https://huggingface.co/new-space |
| 2. املأ البيانات: |
| - **Space name**: `geo-guard` |
| - **License**: MIT |
| - **SDK**: اختر **Gradio** ✅ |
| - **Hardware**: `CPU Basic` (مجاني) |
| 3. اضغط **Create Space** |
|
|
| --- |
|
|
| ## الخطوة 3️⃣ – رفع الملفات (طريقتين) |
|
|
| ### 🅰️ الطريقة الأسهل: رفع مباشر من الموقع |
| 1. افتح الـ Space اللي أنشأته |
| 2. اضغط **Files** ثم **Add file** ثم **Upload files** |
| 3. ارفع الملفات الثلاثة: |
| - `app.py` |
| - `requirements.txt` |
| - `README.md` |
| 4. اضغط **Commit changes** |
|
|
| ### 🅱️ الطريقة الاحترافية: Git |
| ```bash |
| # تثبيت git-lfs |
| git lfs install |
| |
| # استنساخ الـ Space |
| git clone https://huggingface.co/spaces/اسمك/geo-guard |
| cd geo-guard |
| |
| # نسخ الملفات |
| cp app.py requirements.txt README.md . |
| |
| # رفع |
| git add . |
| git commit -m "🚀 Initial upload - GeoGuard AI" |
| git push |
| ``` |
|
|
| --- |
|
|
| ## الخطوة 4️⃣ – انتظر البناء التلقائي |
| - بعد الرفع، HuggingFace هيبني المشروع تلقائياً ⚙️ |
| - الوقت: 3-5 دقائق |
| - هتلاقي شاشة Building ثم Running ✅ |
|
|
| --- |
|
|
| ## الخطوة 5️⃣ – شارك الرابط 🎉 |
| رابط مشروعك هيكون: |
| ``` |
| https://huggingface.co/spaces/اسمك/geo-guard |
| ``` |
|
|
| --- |
|
|
| ## ⚠️ ملاحظات مهمة |
| - الـ `CPU Basic` مجاني بس بطيء شوية |
| - لو عايز GPU أسرع: اختر `T4 Small` (مدفوع) |
| - أول مرة النموذج بيتحمل (49MB) ممكن ياخد دقيقة |
| - لو الـ Space وقف، هيشتغل تاني لما حد يفتحه |
|
|
