MaherAbderrahim/Tunisian-Sign-Language-Translator

Traduction de la langue des signes tunisienne (TSL) vers le dialecte tunisien, français, anglais et arabe - FastAPI + Streamlit + MediaPipe # 🇹🇳 Tunisian Sign Language Translator (TSL) **Un système qui traduit la langue des signes tunisienne (TSL) en texte.** Montre un signe à la caméra → il est reconnu → traduit en **tunisien, français, anglais et arabe** — 100 % hors ligne. ## ✨ Comment ça marche ? (en 30 secondes) ``` Caméra / Image / Vidéo │ ▼ MediaPipe détecte les mains (21 points par main) │ ▼ Modèle de deep learning reconnaît le signe (57 signes TSL) │ ▼ Dictionnaire + traduction → tunisien, français, anglais, arabe │ ▼ Résultat à l'écran / via l'API ``` --- ## 🚀 Démarrage rapide ```bash git clone github.com cd Tunisian-Sign-Language-Translator python -m venv venv venv\Scripts\activate # Windows source venv/bin/activate # Linux / Mac pip install -r requirements.txt ``` --- ## 🖥️ Comment l'utiliser ? ### 1. L'interface web (la plus simple) → recommandée ```bash python -m streamlit run web/app.py ``` Ouvre **http://localhost:8501** dans ton navigateur. 5 onglets : | Onglet | Que fait-il ? | |---|---| | **Drop Image** | Traduire une image de signe | | **Upload Video** | Reconnaître les signes en continu dans une vidéo | | **Camera** | Traduction en direct depuis la webcam | | **Text Translator** | Traduire du texte en plusieurs langues | | **Dictionary** | Consulter le dictionnaire des signes | ### 2. L'API REST (pour les développeurs) ```bash python -m uvicorn api.main:app --host 0.0.0.0 --port 8000 ``` - Documentation interactive : **localhost - Vérifier que tout fonctionne : **localhost → `{"status":"healthy"}` ### 3. La ligne de commande ```bash python demo.py # petite démo python -m pytest tests/test_all.py -v # exécute tous les tests ``` --- ## 🔌 Principales routes de l'API | Méthode | Route | Description | |---|---|---| | `POST` | `/translate/frame` | Reconnaître un signe dans une image (upload) | | `POST` | `/translate/text` | Tradui …