README.md

---
title: Sign Language Translator API
emoji: 🤟
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
---

# 🤟 Sign Language Translator API

Real-time **Arabic & English** Sign Language recognition using **CNN-BiLSTM + MediaPipe**.

## Endpoints

| Method | URL | Description |
|--------|-----|-------------|
| GET | `/` | API info |
| GET | `/health` | Model status |
| POST | `/predict/english` | Predict English ASL letter |
| POST | `/predict/arabic` | Predict Arabic ARSL letter |

## How to use

Send a hand-gesture image (JPG/PNG) as `multipart/form-data`:

```bash
curl -X POST "https://<your-space>.hf.space/predict/english" \
     -F "file=@hand.jpg"
```

### Response example

```json
{
  "language": "english",
  "predicted_label": "A",
  "predicted_char": "A",
  "confidence": 0.9823,
  "above_threshold": true,
  "message": "OK"
}
```

```json
{
  "language": "arabic",
  "predicted_label": "Alef",
  "predicted_char": "ا",
  "confidence": 0.9412,
  "above_threshold": true,
  "message": "OK"
}
```

## Model details

- Input: single hand-gesture image
- MediaPipe extracts 21 landmarks → 63 features
- Sequence replicated to 23 timesteps → shape `(1, 23, 63)`
- CNN + BiLSTM → Softmax
- Confidence threshold: **0.8**
- English classes: 28 (A-Z + del + space)
- Arabic classes: 33