mpairwe7/magezi-ai

Magezi AI — A-Level STEM Tutor for Uganda # Magezi — "The Wise One" **Wisdom in your language — A-Level STEM Tutor** > Helping rural students master the 2025 Competence-Based Curriculum, one step at a time. --- ## The Problem Over **70% of Uganda's A-Level students** attend rural schools where qualified STEM teachers are scarce. The 2025 NCDC Competence-Based Curriculum demands higher-order thinking — but most students have no one to guide them. **Magezi** is an AI tutor that speaks the student's language (Luganda, Swahili, Runyankole, English), follows the official NCDC 2025 syllabus, and teaches step by step. ## How It Works ``` Student asks a question (voice or text, any language) → Input guardrails (injection + cheating detection) → Supervisor classifies subject (zero-latency keyword classifier) → Agentic tutor plans response (complexity, multi-retrieval, tools) → Curriculum RAG (4,457 passages from 288 official NCDC PDF pages) → STEM tools inject verified formulas + constants → Groq Llama 3.3 70B generates pedagogical response (with retry) → Fallback: structured local response if LLM unavailable → Markdown rendering (headers, bold, lists, code, tables) → Faithfulness scoring + citations to exact syllabus pages → Multi-turn context (5-turn sliding window per session) ``` ## Key Features | Feature | Description | |---------|-------------| | **Groq LLM** | Llama 3.3 70B via Groq — fast inference with auto-retry on 429 | | **4,457 Passages** | 288 pages of official NCDC 2025 PDFs + structured JSON syllabus | | **4 Languages** | Luganda, Swahili, Runyankole, English — 120-term multilingual bridge | | **4 Subjects** | Physics, Chemistry, Biology, Mathematics (A-Level) | | **Agentic Tutor** | Plans before answering: complexity analysis, multi-retrieval, tool use | | **STEM Tools** | 18 physical constants + 47 formulas + safe calculator | | **Markdown Chat** | react-markdown + remark-gfm: headers, bold, lists, code, tables render properly | | **Grok-Style Actions** | Copy, Regenerate, Listen, T …