gabrielmahia/shule-ai

ShuleAI — AI tutor for Kenya curriculum. KCPE/KCSE prep, CBC syllabus, answers in Kiswahili and English. Runs on any phone. Open-source. # 📚 ShuleAI — Kenya Curriculum AI Tutor > AI tutor for KCPE and KCSE students. CBC syllabus. Answers in Kiswahili and English. Runs on any phone with a browser — no app install required. ## What it does ShuleAI is a free AI study companion grounded in the Kenya Institute of Curriculum Development (KICD) syllabus. It answers exam questions, explains concepts, generates practice problems, and gives worked solutions — all in plain language. | Feature | Description | |---------|-------------| | 📖 **Subject coverage** | Mathematics, English, Kiswahili, Sciences, History, Geography, CRE | | 🗣️ **Bilingual** | Explains in English and Kiswahili on request | | 📝 **Practice generator** | Generates KCPE/KCSE-style practice questions with worked answers | | 🧮 **Worked solutions** | Step-by-step math and science solutions | | 📱 **Mobile-first** | Designed for phone screens — no app download needed | | 🔒 **Safe** | Content-filtered for age-appropriate responses; no personal data stored | ## Live demo 🌐 shule-ai.streamlit.app ## Quickstart ```bash git clone github.com cd shule-ai pip install -r requirements.txt export ANTHROPIC_API_KEY=your_key streamlit run app.py ``` ## Why this exists Kenya has 9 million primary school pupils and 3.5 million secondary students. The average pupil-to-teacher ratio is 45:1. Most students in rural areas have no access to private tutors. A phone with data and ShuleAI changes that. ShuleAI is grounded in the KICD syllabus — it won't answer questions outside the curriculum, and it won't do students' homework without teaching the concept first. ## Example interactions ``` Student: Explain photosynthesis for Form 2 Biology ShuleAI: Photosynthesis ni mchakato ambao mimea hutumia jua, maji, na dioksidi ya kaboni kutengeneza chakula... [Full bilingual explanation follows] Student: Give me 5 KCPE maths practice questions on fractions ShuleAI: [Generates 5 graded questions with worked solutions] Student: I got …