README.md

metadata

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:

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

Response example

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

{
  "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