Spaces:
Build error
Build error
Upload DEPLOYMENT_GUIDE.md
Browse files- DEPLOYMENT_GUIDE.md +145 -0
DEPLOYMENT_GUIDE.md
ADDED
|
@@ -0,0 +1,145 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# 🚀 دليل النشر السريع على Hugging Face Spaces
|
| 2 |
+
|
| 3 |
+
## الخطوات (5 دقائق فقط!)
|
| 4 |
+
|
| 5 |
+
### 1️⃣ إنشاء حساب Hugging Face
|
| 6 |
+
- اذهب إلى https://huggingface.co/join
|
| 7 |
+
- سجّل حساب جديد (مجاني تماماً)
|
| 8 |
+
|
| 9 |
+
### 2️⃣ إنشاء Space جديد
|
| 10 |
+
1. اذهب إلى https://huggingface.co/spaces
|
| 11 |
+
2. اضغط **"Create new Space"**
|
| 12 |
+
3. املأ المعلومات:
|
| 13 |
+
```
|
| 14 |
+
Space name: lipsync-studio-arabic
|
| 15 |
+
License: MIT
|
| 16 |
+
SDK: Gradio
|
| 17 |
+
Hardware: CPU basic (للاختبار) أو GPU T4 (للإنتاج)
|
| 18 |
+
```
|
| 19 |
+
|
| 20 |
+
### 3️⃣ رفع الملفات
|
| 21 |
+
|
| 22 |
+
**طريقة أ: من خلال الموقع**
|
| 23 |
+
1. في صفحة Space، اضغط **"Files"**
|
| 24 |
+
2. اضغط **"Add file"** → **"Upload files"**
|
| 25 |
+
3. ارفع هذه الملفات بالترتيب:
|
| 26 |
+
- ✅ `app.py`
|
| 27 |
+
- ✅ `requirements.txt`
|
| 28 |
+
- ✅ `index.html`
|
| 29 |
+
- ✅ `README.md`
|
| 30 |
+
- ✅ `packages.txt`
|
| 31 |
+
- ✅ `.gitignore`
|
| 32 |
+
|
| 33 |
+
**طريقة ب: باستخدام Git**
|
| 34 |
+
```bash
|
| 35 |
+
# 1. استنساخ Space
|
| 36 |
+
git clone https://huggingface.co/spaces/YOUR_USERNAME/lipsync-studio-arabic
|
| 37 |
+
cd lipsync-studio-arabic
|
| 38 |
+
|
| 39 |
+
# 2. نسخ الملفات
|
| 40 |
+
cp /path/to/files/* .
|
| 41 |
+
|
| 42 |
+
# 3. رفع
|
| 43 |
+
git add .
|
| 44 |
+
git commit -m "🎬 First deployment"
|
| 45 |
+
git push
|
| 46 |
+
```
|
| 47 |
+
|
| 48 |
+
### 4️⃣ إعداد GPU (اختياري - موصى به)
|
| 49 |
+
|
| 50 |
+
1. في صفحة Space، اضغط **"Settings"**
|
| 51 |
+
2. في قسم **"Hardware"**:
|
| 52 |
+
- للاختبار: `CPU basic` (مجاني)
|
| 53 |
+
- للإنتاج: `GPU T4` (~$0.60/ساعة)
|
| 54 |
+
- للأداء العالي: `GPU A10G` (~$3/ساعة)
|
| 55 |
+
3. اضغط **"Save"**
|
| 56 |
+
|
| 57 |
+
### 5️⃣ الانتظار والتشغيل
|
| 58 |
+
|
| 59 |
+
- سيبدأ Space في البناء تلقائياً
|
| 60 |
+
- وقت البناء: 5-15 دقيقة (أول مرة)
|
| 61 |
+
- ستظهر رسالة "Running" عند الجاهزية
|
| 62 |
+
- افتح الرابط وجرّب!
|
| 63 |
+
|
| 64 |
+
---
|
| 65 |
+
|
| 66 |
+
## 🔧 حل مشاكل شائعة
|
| 67 |
+
|
| 68 |
+
### ❌ "Application startup failed"
|
| 69 |
+
**السبب**: مشكلة في requirements.txt
|
| 70 |
+
**الحل**:
|
| 71 |
+
1. افتح **Logs** في Space
|
| 72 |
+
2. ابحث عن الخطأ
|
| 73 |
+
3. عدّل requirements.txt
|
| 74 |
+
4. اضغط **Restart Space**
|
| 75 |
+
|
| 76 |
+
### ❌ "Out of memory"
|
| 77 |
+
**السبب**: CPU لا يكفي
|
| 78 |
+
**الحل**: قم بالترقية إلى GPU T4
|
| 79 |
+
|
| 80 |
+
### ❌ "Model not found"
|
| 81 |
+
**السبب**: النماذج لم تنزّل
|
| 82 |
+
**الحل**: أضف سكربت تنزيل تلقائي في app.py
|
| 83 |
+
|
| 84 |
+
---
|
| 85 |
+
|
| 86 |
+
## 📊 خيارات Hardware
|
| 87 |
+
|
| 88 |
+
| النوع | RAM | السعر/ساعة | الأداء |
|
| 89 |
+
|------|-----|-----------|--------|
|
| 90 |
+
| CPU basic | 16GB | مجاني | بطيء (2-5 دقائق/فيديو) |
|
| 91 |
+
| CPU upgrade | 32GB | $0.03 | متوسط (1-3 دقائق/فيديو) |
|
| 92 |
+
| GPU T4 | 16GB | $0.60 | سريع (10-30 ثانية/فيديو) |
|
| 93 |
+
| GPU A10G | 24GB | $3.15 | سريع جداً (5-15 ثانية/فيديو) |
|
| 94 |
+
|
| 95 |
+
---
|
| 96 |
+
|
| 97 |
+
## 🎯 نصائح للنجاح
|
| 98 |
+
|
| 99 |
+
### ✅ افعل:
|
| 100 |
+
- استخدم GPU للإنتاج
|
| 101 |
+
- اختبر محلياً أولاً
|
| 102 |
+
- راقب Logs بانتظام
|
| 103 |
+
- اقرأ تعليقات المستخدمين
|
| 104 |
+
|
| 105 |
+
### ❌ لا تفعل:
|
| 106 |
+
- لا تترك GPU مفعّلاً دون استخدام (سيُكلفك!)
|
| 107 |
+
- لا ترفع ملفات كبيرة (>10MB) في Git
|
| 108 |
+
- لا تنسى إضافة .gitignore
|
| 109 |
+
|
| 110 |
+
---
|
| 111 |
+
|
| 112 |
+
## 📞 تحتاج مساعدة؟
|
| 113 |
+
|
| 114 |
+
- 📖 الوثائق: https://huggingface.co/docs/hub/spaces
|
| 115 |
+
- 💬 المنتدى: https://discuss.huggingface.co
|
| 116 |
+
- 🐛 Issues: https://github.com/huggingface/huggingface_hub/issues
|
| 117 |
+
|
| 118 |
+
---
|
| 119 |
+
|
| 120 |
+
## 🎉 بعد النشر
|
| 121 |
+
|
| 122 |
+
### مشاركة Space
|
| 123 |
+
```
|
| 124 |
+
رابط Space: https://huggingface.co/spaces/YOUR_USERNAME/lipsync-studio-arabic
|
| 125 |
+
رابط Embed: https://YOUR_USERNAME-lipsync-studio-arabic.hf.space
|
| 126 |
+
```
|
| 127 |
+
|
| 128 |
+
### إضافة Badge إلى README
|
| 129 |
+
```markdown
|
| 130 |
+
[](https://huggingface.co/spaces/YOUR_USERNAME/lipsync-studio-arabic)
|
| 131 |
+
```
|
| 132 |
+
|
| 133 |
+
### تضمين في موقعك
|
| 134 |
+
```html
|
| 135 |
+
<iframe
|
| 136 |
+
src="https://YOUR_USERNAME-lipsync-studio-arabic.hf.space"
|
| 137 |
+
frameborder="0"
|
| 138 |
+
width="850"
|
| 139 |
+
height="450"
|
| 140 |
+
></iframe>
|
| 141 |
+
```
|
| 142 |
+
|
| 143 |
+
---
|
| 144 |
+
|
| 145 |
+
**صنع بـ ❤️ - حظاً موفقاً! 🚀**
|