AbrhamTesf/AI-tutor-for-Ethiopian-elementary-students

# Amharic Tutoring Agent for Ethiopian National Exams 🇪🇹 ## 🌟 Project Overview An AI-powered tutoring agent designed to help Ethiopian students prepare for national exams. The agent communicates in **Amharic** and provides accurate, curriculum-aligned explanations and practice problems. The primary goal is to create a valuable educational resource for students whose parents or family members may not be able to help with homework due to language barriers (e.g., if they don't understand English) or lack of subject knowledge. ## ✨ Features - **Amharic Language Support:** The agent can understand and respond in fluent Amharic, making it accessible to a wider audience. - **Curriculum-Aligned Knowledge:** The core knowledge base is built from official Ethiopian national exam textbooks and past papers. - **Problem-Solving Assistance:** The agent provides step-by-step guidance for solving complex problems. - **Conversational Interface:** Designed to be a supportive and easy-to-use learning companion. - **Multi-Grade Support:** Currently supports Grade 6, Grade 8 and Grade 12 Mathematics. - **Interactive Quizzes:** Generate practice questions based on the curriculum. ## 🛠️ Technical Stack - **Backend:** Python, Flask - **Language Model:** Fine-tuned multilingual model (Initial implementation uses mT5, with plans to integrate Walia-LLM) - **NLP Libraries:** `etnltk`, `transformers`, `sentence-transformers` - **Vector Database:** FAISS for efficient similarity search - **Data Processing:** pandas, PyPDF2, pdfplumber - **Deployment:** Docker containerization, with options for Heroku or local server deployment ## 📁 Project Structure amharic-tutoring-agent/ ├── data/ # Curriculum data and embeddings ├── models/ # Pretrained and fine-tuned models ├── src/ # Core application code ├── tests/ # Unit and integration tests ├── frontend/ # Web interface (for future phases) ├── config/ # Configuration files ├── scripts/ # Utility scripts ├── docs/ # Documentation ├── requirements …