Open-Source Tool · Python · Education

Elimu Research Assistant

AI-powered research tool enabling Kenyan educators to generate locally relevant, credibly sourced educational content — in minutes, not hours.

Install
pip install elimu-research-assistant v1.1.1 · Python 3.9+ · MIT License · PyPI →

The Problem

Imagine a Kenyan geography teacher trying to explain economic principles using examples from a textbook written in London. The lesson falls flat. Now imagine that same teacher, in minutes, generating a custom handout on the economic impact of the new Lamu Port, complete with local statistics and sources. This is the gap Elimu Research Assistant fills.

The Solution

Elimu Research Assistant is not another search engine. It's an intelligent assistant that understands a teacher's educational needs, conducts targeted web research using the ReAct (Reasoning + Acting) framework, and delivers structured, ready-to-use content that is both locally relevant and credibly sourced.

Context-Aware Content

Generates coherent, structured documents tailored to specific grade levels, subjects, and Kenyan contexts — ready for classroom use.

Flexible Formats

Lesson plans, student handouts, comparison tables, teacher references, and assessment materials — adapt to what you need.

Credible Local Sources

Prioritises Kenyan universities, KICD, and government publications while combining local and global perspectives with proper citations.

ReAct Framework

Iteratively reasons and acts — searching, reading, and synthesising information to produce accurate, well-grounded output.

How It Works

graph TD A[Teacher Request] --> B[Educational Task Analysis] B --> C[Kenya-Focused Search Strategy] C --> D[Multi-Source Research] D --> E[Context-Aware Synthesis] E --> F[Educational Content Format] F --> G[Ready-to-Use Materials] style B fill:#e1f5fe,stroke:#90caf9,color:#0d47a1 style E fill:#e8f5e9,stroke:#a5d6a7,color:#1b5e20 style F fill:#fff3e0,stroke:#ffcc80,color:#e65100

Architecture: ReAct pipeline from teacher request to ready-to-use classroom material

Sample Use Cases

Science "Create a lesson plan on renewable energy focusing on Kenya's geothermal projects in Olkaria."
elimu — bash
$ elimu research "Create a lesson plan on renewable energy focusing on Kenya's geothermal projects in Olkaria"

  Thought: Need current Olkaria capacity data and CBC Form 3 Science curriculum alignment.
  Action:  search("KenGen Olkaria geothermal capacity MW 2024")
  Obs:     Olkaria complex: 863 MW installed — 47% of Kenya's capacity. Expansion to 1,745 MW by 2030.

  Thought: Now find CBC curriculum alignment for energy topics.
  Action:  search("CBC Kenya Form 3 Science energy strand KICD syllabus")
  Obs:     Energy in Strand 4.2 — KICD guidelines require local case studies for contextualised learning.

  Action:  search("Olkaria geothermal environmental impact local community benefits")
  Obs:     Maasai community electricity access up 78% (2019–2023). CO₂ offset: 1.3M tonnes/year.

  ✓ Synthesising 5 sources — generating lesson plan...

LESSON PLAN: Renewable Energy & Kenya's Geothermal Future (Form 3 Science)
────────────────────────────────────────────────────────────────────────
Duration: 80 min  |  Strand: 4.2 Energy  |  Sources cited: 5
Learning objectives (3)  |  Activities (4)  |  Discussion prompts (2)
→ Saved: lesson_geothermal_olkaria.md
Mathematics "Generate word problems using Kenyan currency, distances between major cities, and local business scenarios."
elimu — bash
$ elimu research "Generate word problems using Kenyan currency, distances between major cities, and local business scenarios"

  Thought: Need real distances, current KES exchange rates, and authentic local business contexts.
  Action:  search("road distances Kenya major cities km KENHA 2024")
  Obs:     Nairobi–Mombasa: 485 km. Nairobi–Kisumu: 350 km. Nairobi–Eldoret: 312 km.

  Action:  search("small business statistics Kenya MSME Revenue 2024")
  Obs:     Average Nairobi kiosk turnover: KES 45,000/month. Matatu routes avg 18 trips/day.

  ✓ Generating 8 contextualised word problems...

WORD PROBLEM SET: Kenyan Contexts (Form 2 Mathematics)
──────────────────────────────────────────────────────
Problem 1: A matatu from Nairobi to Nakuru (156 km) charges KES 350...
Problem 2: Aisha's mama mboga stall earns KES 3,200 on weekdays...
Problem 3: The SGR Nairobi–Mombasa covers 485 km in 4h 30min...
  + 5 more problems with worked solutions
→ Saved: maths_word_problems_kenya.md
Literature "Compile a study guide comparing Ngũgĩ wa Thiong'o and Grace Ogot."
elimu — bash
$ elimu research "Compile a study guide on themes in Kenyan literature comparing Ngugi wa Thiong'o and Grace Ogot"

  Thought: Need scholarly analysis of both authors' major themes, historical context, and CBC set texts.
  Action:  search("Ngugi wa Thiong'o major themes postcolonialism language identity")
  Obs:     Core themes: decolonisation of the mind, land dispossession, language as power (Gikuyu vs English).

  Action:  search("Grace Ogot The Promised Land themes Luo culture oral tradition")
  Obs:     Themes: gender and tradition, cultural dislocation, spiritual belief, female agency.

  ✓ Synthesising — building comparison study guide...

STUDY GUIDE: Ngũgĩ wa Thiong'o vs Grace Ogot
────────────────────────────────────────────
Theme comparison table (6 dimensions)  |  Historical timeline
Key quotes with analysis  |  Essay prompts (4)  |  Sources: 7
→ Saved: literature_ngugi_ogot_study_guide.md
Business Studies "Generate a 2-page brief for Form 3 on M-Pesa's impact on small enterprises in Kenya, including three Rift Valley examples."
elimu — bash
$ elimu research "Generate a 2-page brief for Form 3 Business Studies on M-Pesa's impact on small enterprises, three Rift Valley examples"

  Thought: Need M-Pesa statistics, Rift Valley-specific MSME data, and Form 3 Business Studies scope.
  Action:  search("M-Pesa impact small business Kenya statistics CBK 2024")
  Obs:     67% of Kenyan SMEs use M-Pesa for transactions. Transaction value: KES 36.6T in 2023 (CBK).

  Action:  search("M-Pesa Rift Valley Nakuru Eldoret Kericho small business")
  Obs:     Nakuru flower farms, Kericho tea cooperatives, Eldoret grain traders — all cite M-Pesa for payments.

  ✓ Generating 2-page structured brief...

BRIEF: M-Pesa & Small Enterprise Growth in Kenya's Rift Valley (Form 3)
────────────────────────────────────────────────────────────────────────
Section 1: M-Pesa overview & national impact statistics
Section 2: Rift Valley case studies — Nakuru | Kericho | Eldoret
Section 3: Discussion questions & further reading  |  Sources: 6
→ Saved: business_mpesa_rift_valley_brief.md
Project Status: The Elimu Research Assistant is currently in its pilot phase, being co-developed and validated with a cohort of Kenyan secondary school teachers. Feedback from the field is actively shaping v2.0 priorities.

Links