agudu50/CodeTutor-Africa

# 🌍 CodeTutor Africa **Offline-First AI Programming Tutor for African Students** -purple.svg>) --- ## 🌐 Live Production Demo & Quick Links - **Live Web App**: **code-tutor-africa.vercel.ap… - **Technical Report**: REPORT.md - **ADTC Submission Metadata**: submission.json - **Local Backend API**: `127.0.0.1` - **Local Frontend**: `localhost` --- ## 📖 1. Problem Statement & Motivation Across African universities, computer science and engineering students frequently encounter steep roadblocks in mastering programming: 1. **Unreliable Internet & High Data Costs**: Cloud-hosted AI coding assistants (e.g. ChatGPT, Claude, Copilot) require constant high-speed connectivity and costly API subscriptions, rendering them inaccessible in low-bandwidth regions and offline university labs. 2. **Commodity Hardware Constraints**: The standard university student laptop is a commodity machine (typically **8 GB RAM, Intel Core i5 10th–12th Gen or AMD Ryzen 5, integrated graphics only, and 256 GB SSD**). Running heavyweight AI systems locally often causes catastrophic out-of-memory (OOM) crashes, extreme battery drain, or severe CPU thermal throttling. 3. **The "Copy-Paste" Pedagogical Flaw**: Generic generative LLMs provide direct, unverified answers to assignments, depriving students of essential problem-solving intuition, mental model formation, and debugging skills. ### 💡 The Solution: CodeTutor Africa **CodeTutor Africa** is an offline-first, highly optimized AI programming tutor, dynamic curriculum generator, and VS Code-embedded sandbox engineered to execute 100% locally on an 8 GB RAM laptop without requiring GPUs, internet access, or cloud APIs. --- ## 🎯 2. ADTC 2026 Profiler & Scoring Alignment CodeTutor Africa is engineered from the ground up for the official **Africa Deep Tech Challenge (ADTC) 2026 Laptop LLM Track** competition benchmark: $$\mathbf{S_{total}} = 0.50 \cdot S_{acc} + 0.30 \cdot S_{perf} + 0.20 \cdot S_ …