agudu50/CodeTutor-Africa-beta

# 💻 CodeTutor Africa **Adaptive AI Programming Tutor, Dynamic Curriculum Generator & Interactive Sandbox** --Ready-success.svg) --- ## 🌐 Live Demo & Endpoints - **Live Production URL**: **code-tutor-africa.vercel.ap… - **Local Backend**: `127.0.0.1` - **Local Frontend**: `localhost` --- ## 📖 1. Overview & Motivation Learning to program effectively requires active practice, guided debugging, and deep conceptual understanding. However, modern learners, developers, and academic institutions face significant hurdles: 1. **Connectivity & Flexibility**: Mainstream coding assistants often strictly rely on proprietary cloud platforms, leaving users stranded during low-bandwidth or offline sessions, while purely offline systems lack scalable web access and quick deployment. 2. **Privacy & Infrastructure Overheads**: Sending private code and assignments to untrusted external third-party endpoints raises privacy concerns, whereas running heavy models locally can strain commodity devices without proper optimization. 3. **The "Copy-Paste" Pedagogical Flaw**: Generic generative models tend to dump ready-made solutions, depriving learners of essential problem-solving intuition, mental model formation, and real debugging skills. ### 💡 The Solution: CodeTutor **CodeTutor** is an adaptive, hybrid AI programming tutor, dynamic curriculum generator, and embedded sandbox. It is engineered with a **flexible architecture** that seamlessly supports both **cloud-hosted web deployments** and **optimized local/offline environments**—delivering Socratic pedagogy, real-time code evaluation, and interactive curriculum synthesis across any setup. --- ## 🏗️ 2. System Architecture CodeTutor follows a clean **Modular Monolith** architecture separating presentation, domain logic, and provider runtimes: ``` ┌────────────────────────────────────────┐ │ FRONTEND (React + Vite) │ │ • Socratic Chat & SSE Token Streaming │ │ • AI Cou …