gabrielmahia/shule-ai
Domain:
educationnatural language processingRecord type:
softwaretools
Creator:
gab
Host:
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 …