Upload README (1).md

README (1).md

@@ -0,0 +1,47 @@
+---
+title: Arabic Sign Language Interpreter
+emoji: 🤟
+colorFrom: green
+colorTo: blue
+sdk: docker
+pinned: false
+app_port: 8000
+---
+
+# Arabic Sign Language Interpreter API v2.0
+
+REST API لتفسير لغة الإشارة العربية — يقبل صورة يد ويرجع الحرف أو الرقم المقابل.
+
+## البايبلاين
+
+```
+Image → YOLO Detection → WiLoR 3D Pose → Stage-1 Classifier → Stage-2 MLP → Sign Label
+```
+
+## الـ Endpoints
+
+- `GET /` — Health check
+- `POST /predict` — رفع صورة يد والحصول على التنبؤ
+- `POST /predict_with_skeleton` — نفس `/predict` + مفاصل 3D + crop
+- `GET /info` — معلومات الـ runtime
+
+## مثال
+
+```bash
+curl -X POST \
+  "https://YOUR_USERNAME-arabic-sign-language-interpreter.hf.space/predict" \
+  -F "file=@hand.jpg"
+```
+
+**Response:**
+```json
+{
+  "sign": "ب",
+  "sign_confidence": 0.9731,
+  "category": "letter",
+  "category_confidence": 0.9812,
+  "hand_side": "right",
+  "bbox": [120, 85, 340, 310],
+  "mode": "full"
+}
+```