# 🚀 خطوات رفع 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 وقف، هيشتغل تاني لما حد يفتحه