Fizzy9913/Offline-Math-Tutor-Ai

AI-powered mathematics tutoring platform for Ghana JHS students (B7, B8, B9) with offline capabilities # 🇬🇭 MATH TUTOR-AI > An intelligent, offline-capable virtual learning platform providing personalized mathematics tutoring for Ghana Junior High School students (B7, B8, B9) using AI technology. ## 🌟 Features ### For Students - **🤖 AI Math Tutor**: Interactive chatbot with step-by-step explanations - **📚 Comprehensive Content**: Complete GES curriculum coverage (B7, B8, B9) - **📊 Progress Tracking**: Detailed analytics and performance metrics - **🔖 Bookmark System**: Save difficult topics for revision - **📱 Offline Support**: Works completely offline with PWA capabilities - **🎯 Practice Tests**: Interactive MCQs and short answer questions ### For Teachers - **👨‍🏫 Admin Panel**: Complete content management system - **📤 Content Upload**: Add questions, examples, and notes - **📊 Student Analytics**: Monitor class performance and individual progress - **📋 Reports & Export**: Generate detailed performance reports - **🚨 Error Reporting**: Manage student feedback and content issues ### Technical Features - **🔒 Authentication System**: Role-based access (Student/Teacher/Guest) - **💾 Offline Storage**: LocalStorage and IndexedDB for data persistence - **🎨 Modern UI**: Built with React, TypeScript, and Tailwind CSS - **📱 Responsive Design**: Works on desktop, tablet, and mobile - **⚡ Fast Performance**: Optimized with Vite and code splitting ## 🚀 Quick Start ### Prerequisites - **Node.js 18+** (Download) - **Python 3.8+** (Download) - **Ollama** (Download) ### Installation 1. **Clone the repository** ```bash git clone github.com cd ghana-ai-math-buddy ``` 2. **Install frontend dependencies** ```bash npm install ``` 3. **Set up AI service** ```bash cd ai_service pip install -r requirements.txt python setup_model.py ``` 4. **Start the application** ```bash # Terminal 1: Start Ollama server ollama serve # Terminal 2: Start AI service cd ai_service python -m uvicorn app:app --host 127.0.0.1 --port 8001 # Terminal 3: …