True-African/Early-math-tutor-offline

Offline early numeracy tutor for ages 5–9 with adaptive practice, multilingual support, and simple parent progress summaries. --- title: Early Math Tutor Offline sdk: gradio app_file: app.py short_description: Offline adaptive math tutor for ages 5-9. --- # Early Math Tutor Offline Early Math Tutor Offline is a child-friendly numeracy tutor for ages 5 to 9. It teaches counting, number sense, addition, subtraction, and simple word problems through visuals, adaptive practice, multilingual prompts, microphone or tap response, and a simple weekly parent report. ## Hosted links - GitHub: - Hugging Face Space: Clone from GitHub: ```bash git clone github.com cd Early-math-tutor-offline ``` Clone from Hugging Face: ```bash git clone huggingface.co cd Early-math-tutor-offline ``` ## What this project currently does - runs offline at inference time - uses Bayesian Knowledge Tracing to choose the next item - supports Kinyarwanda, English, French, and mixed response detection - supports tap response and microphone capture - loads a local Whisper Tiny ASR model when present - prefers a quantized CTranslate2 `faster-whisper` ASR export on CPU edge devices when present - loads a local LoRA feedback adapter when present - falls back to simple template feedback when the tiny language model output is weak - stores learner progress locally in SQLite - shows learner, parent, and system dashboards in Gradio - exports one standalone HTML results dashboard to `outputs/results_dashboard.html` ## Current measured results - BKT AUC: `0.6013` - Elo baseline AUC: `0.6180` - Replay size: `2880` answer events across `120` synthetic learners Footprint note: ```bash du -sh tutor/ ``` Current measured package size for `tutor/`: - about `0.111 MB` ## Quick start Create a virtual environment: ```powershell python -m venv venv ``` Activate it using the command for your terminal: Windows Git Bash: ```bash source venv/Scripts/activate ``` Windows PowerShell: ```powershell .\venv\Scripts\Activate.ps1 ``` Win …