mithranm/wolof

# Wolof Pronunciation Game A web-based pronunciation learning game for Wolof language with AI-powered scoring. ## Live Demo 🌍 **wolof.mithran.org** - Accessible through Cloudflare tunnel ## Features - **Interactive Gameplay**: Practice Wolof pronunciation with immediate feedback - **AI Scoring**: Powered by speech recognition models - **Modern UI**: React-based frontend with smooth animations - **Cloudflare Deployment**: Global CDN with Workers proxy - **Real-time Processing**: Audio transcription and similarity scoring ## Architecture ``` ┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ React UI │ │ Cloudflare │ │ Local Server │ │ (Browser) │◄──►│ Worker │◄──►│ (Port 49152) │ │ │ │ (Proxy/CORS) │ │ │ └─────────────────┘ └──────────────────┘ └─────────────────┘ ``` ## Quick Start ### Local Development ```bash # Install dependencies conda create -n wolof-game python=3.10 -y conda activate wolof-game pip install flask flask-cors torch transformers librosa requests numpy nvidia-riva-client python-dotenv # Create .env file with your NVIDIA API key echo "PARAKEET_API_KEY=your-api-key-here" > .env # Start the game server PORT=49152 python parakeet_holistic_server.py # Access the game at localhost ``` ### Production Deployment The game is deployed using Cloudflare Workers: - **Frontend**: React app served via Cloudflare Workers - **Backend**: Local server exposed through Cloudflare tunnel - **API Proxy**: Workers handle CORS and proxy requests to local server ## Game Phrases The game includes sample Wolof phrases: - "Nanga def?" (How are you?) - Beginner - "Maa ngi fi." (I am here.) - Beginner - "Xaatim ngaa?" (How are you?) - Beginner - "Noppali na." (It is good.) - Intermediate - "Fan la?" (When?) - Intermediate ## Audio Processing The game uses **holistic pronunciation scoring** combining multiple analysis methods: ### D …