pixeldesignlabs-dev/ai-tutor

Official repository for the ai-powered curriculum aligned personalized tutor for secondary schools in Seychelles. # AI Tutor An AI-powered tutoring platform for secondary school students, built with Django and powered by LLMs (Claude, GPT, Gemini, or local Ollama). Originally designed for Seychelles secondary schools covering Geography and Mathematics, but adaptable to any curriculum. Students learn through structured conversational sessions that follow research-based pedagogy (5E model), with automatic content generation, exit-ticket assessments, prerequisite gating, and real-time progress tracking. --- ## Table of Contents - Features - Architecture Overview - Quick Start - Project Structure - Django Apps - accounts - curriculum - tutoring - dashboard - llm - media_library - safety - Configuration - LLM Providers - Content Generation Pipeline - Management Commands - Deployment - URL Routes - Testing - Contributing - License --- ## Features - **Conversational AI Tutoring** -- LLM-driven sessions following the 5E instructional model (Engage, Explore, Explain, Practice, Evaluate) with Socratic questioning - **Automatic Content Generation** -- Upload a curriculum PDF/DOCX and the system generates lesson steps, media, exit tickets, and skill maps - **RAG Knowledge Base** -- ChromaDB vector store indexes textbooks, teaching materials, and exam papers for context-aware tutoring and content generation - **Multi-Provider LLM Support** -- Anthropic Claude, OpenAI GPT, Google Gemini, Azure OpenAI, or local Ollama with per-purpose model configuration - **Exit Ticket Assessments** -- 35-question banks per lesson, 10 randomly selected per session, 80% pass threshold - **Skill Extraction & Prerequisites** -- Automatic skill graph construction with lesson prerequisite detection and student mastery gating - **Multi-Tenancy** -- Institution-scoped content, users, and configuration with platform-wide curriculum support - **Teacher Dashboard** -- Curriculum management, content review/editing, student progress tracking, safety flagging review - **Adaptive Personalization** -- Difficulty ad …