Wote - AI-powered Ghana Sign Language learning & competitive gaming (Telegram bot + web frontend + ML pipeline) β built for UNICEF Startup Lab (3rd Place, Best AI Implementation).
# Wote β Ghana Sign Language (GSL) Learning Platform
**Wote** is a comprehensive open-source platform for learning and practicing Ghanaian Sign Language (GSL). It provides an integrated suite of tools for beginners to learn signs, practice with AI-powered feedback, play competitive multiplayer games, and contribute to a growing community dictionary.
π **Built for UNICEF Startup Lab β Awarded 3rd Place & Best AI Implementation**
## Key Features
β¨ **Telegram Bot** (`wote_gslbot/`)
- Solo practice mode (3-question quick quizzes with instant feedback)
- 2-player synchronized multiplayer matches with real-time leaderboard
- Integrated GSL dictionary with 100+ signs
- Works via polling (easy demo setup) or webhooks
π **Web Frontend** (`wote_web/` β React + TypeScript)
- Learn module with structured lessons (alphabets, numbers, common words)
- Practice modes (quiz, freestyle, challenge)
- Live webcam sign detection using MediaPipe + TensorFlow.js
- Beautiful Duolingo-style UI with progress tracking and star rewards
- Mock detection mode for reliable demos
π€ **ML Training Pipeline** (`model_training/`)
- Browser-based data collection UI for landmark annotation
- Hybrid neural network training (dense + sequence models)
- Export to TensorFlow.js for browser inference
- Dataset analysis and quality validation tools
π± **Supports Multiple Media Formats**
- Videos: `.mp4`, `.mov`, `.avi`
- Images: `.png`, `.jpg`, `.jpeg`
## Repository Structure
```
codeworks/
βββ wote_gslbot/ # Telegram bot + game engine
β βββ bot_enhanced.py # Main bot (polling + webhook support)
β βββ game_database.py # Game rooms, scoring, leaderboard logic
β βββ database.py # Media and dictionary scanner
β βββ config.py # Configuration with env vars
β βββ requirements.txt # Python dependencies
β βββ data/ # Media assets
β β βββ dictionary.json # GSL dictionary entri β¦