UPLOAD_GUIDE.md

🚀 خطوات رفع 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

# تثبيت 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 وقف، هيشتغل تاني لما حد يفتحه