twiga

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 46 Open GitHub ↗

Twiga is a WhatsApp bot for Tanzanian educators.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![DALL·E Twiga Discord](https://github.com/user-attachments/assets/de0cc88b-b75f-43aa-850c-34c1315a5980)

<h1 align="center">🦒 Twiga: empowering Tanzanian education with AI 🦒</h1>

[![GitHub License](https://img.shields.io/github/license/Tanzania-AI-Community/twiga)](https://github.com/Tanzania-AI-Community/twiga?tab=MIT-1-ov-file)
[![Discord](https://img.shields.io/discord/1260910452683178024?logo=discord&logoColor=%23f6ffff&labelColor=%234a6be4&color=%235a5a5a)](https://discord.gg/bCe2HfZY2C)
[![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/Tanzania-AI-Community/twiga)](https://github.com/Tanzania-AI-Community/twiga/issues)
[![All Contributors](https://img.shields.io/github/all-contributors/Tanzania-AI-Community/twiga?color=ee8449)](https://raw.githubusercontent.com/Tanzania-AI-Community/twiga/development/)
[![Static Badge](https://img.shields.io/badge/thesis_repo-%235b5b5b?logo=github&link=https%3A%2F%2Fgithub.com%2Fjurmy24%2Ftwiga-thesis)](https://github.com/jurmy24/twiga-thesis)

</div>

Twiga is a WhatsApp chatbot designed specifically for Tanzanian teachers, and is being built by the [Tanzania AI Community](https://ai.or.tz/) and open-source contributors. It aims to enhance the educational experience for educators by providing them with access to generative AI. Using retrieval-augmented generation (RAG), Twiga can communicate with teachers in a natural way yet combine the adaptive capabilities of LLMs with the knowledge provided in the curriculum and textbooks of the Tanzanian Institute of Education (TIE). We aim to build the bot to be used for a multitude of educational applications such as generating exams, writing lesson plans, searching for textbook info, and more.

This project was awarded the [Meta Llama Impact Grant Innovation Award 2024](https://ai.meta.com/blog/llama-impact-grant-innovation-award-winners-2024/) for its use of Llama open source LLMs for social good. Read our [roadmap](https://docs.google.com/document/d/1zus2AFyglt1RJdLeqWeAJIT-uHQh6NeU9WuamzAd-0s/edit?usp=sharing) for further details on our development plans.

## 🩷 Sponsors

We would like to thank those who are sponsoring this project.

<table align="center" style="background-color:#f9f9f9; padding:20px; border-radius:10px; width:100%; table-layout:fixed;">
 <colgroup>
 <col style="width:50%;">
 <col style="width:50%;">
 </colgroup>
 <tr>
 <td align="center" style="padding:22px 20px; vertical-align:top;">
 <a href="https://ai.meta.com/blog/llama-impact-grant-innovation-award-winners-2024/" style="display:block; margin:14px 0 10px;">
 <img src="https://github.com/user-attachments/assets/b638f1e6-5a63-4406-bbc5-829341b167ab" alt="Meta" height="60" style="display:block;">
 </a>
 
 Meta 
 Sponsoring us through the LLaMA Impact Grant Innovation Award, allowing us to build LLM tools for social good.
 
 </td>
 <td align="center" style="padding:22px 20px; vertical-align:top;">
 <a href="https://neon.tech/" style="display:block; margin:14px 0 10px;">
 <img src="https://github.com/user-attachments/assets/cf268032-ac06-47ed-a3d9-3bfbbe3a083e" alt="Neon" height="60" style="display:block;">
 </a>
 
 Neon 
 Providing database infrastructure that helps us maintain high performance.
 
 </td>
 </tr>
 <tr>
 <td align="center" style="padding:22px 20px; vertical-align:top;">
 <a href="https://modal.com/" style="display:block; margin:14px 0 10px;">
 <img src="https://modal-cdn.com/modal-logo-icon.png" alt="Modal" height="60" style="display:block;">
 </a>
 
 Modal 
 Providing cloud computing resources for LLM and OCR inference.
 
 </td>
 <td align="center" style="padding:22px 20px; vertical-align:top;">
 <a href="https://kthais.com/" style="display:block; margin:14px 0 10px;">
 <img src="https://avatars.githubusercontent.com/u/57193069?s=200&v=4" alt="KTH AI Society" height="70" style="display:block;">
 </a>
 
 KTH AI Society 
 KTH students' organization that leads some development areas in Twiga.
 
 </td>
 </tr>
</table>

## 📱 Demo

Here are a couple of screenshots. Alternatively, you can take a look at our brief [demo](https://github.com/Tanzania-AI-Community/twiga/blob/main/docs/twiga.gif).

## 🤝 Get involved

We encourage you to contribute to Twiga! There is plenty of documentation describing the current [architecture](https://github.com/Tanzania-AI-Community/twiga/blob/main/docs/en/ARCHITECTURE.md) of Twiga, how to [contribute](https://github.com/Tanzania-AI-Community/twiga/blob/main/docs/en/CONTRIBUTING.md), and how to [get started](https://github.com/Tanzania-AI-Community/twiga/blob/main/docs/en/GETTING_STARTED.md) in the `docs/` folder.

For further support you can join our [Discord](https://discord.gg/bCe2HfZY2C) to discuss directly with the community and stay up to date on what's happening, or you can contact us more formally using GitHub [Discussions](https://github.com/Tanzania-AI-Community/twiga/discussions).

Thank you to all the people that have contributed to Twiga so far!

<table>
 <tbody>
 <tr>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/jurmy24"><img src="https://avatars.githubusercontent.com/u/21913954?v=4?s=100" width="100px;" alt="Victor Oldensand"/>
 Victor Oldensand</a>
 
<a href="#infra-jurmy24" title="infra">🚇</a>
<a href="#code-jurmy24" title="code">💻</a>
<a href="#bug-jurmy24" title="bug">🐛</a>
<a href="#doc-jurmy24" title="doc">📖</a>
<a href="#design-jurmy24" title="design">🎨</a>
<a href="#example-jurmy24" title="example">💡</a>
<a href="#eventOrganizing-jurmy24" title="eventOrganizing">📋</a>
<a href="#fundingFinding-jurmy24" title="fundingFinding">🔍</a>
<a href="#ideas-jurmy24" title="ideas">🤔</a>
<a href="#maintenance-jurmy24" title="maintenance">🚧</a>
<a href="#mentoring-jurmy24" title="mentoring">🧑‍🏫</a>
<a href="#projectManagement-jurmy24" title="projectManagement">📆</a>
<a href="#question-jurmy24" title="question">💬</a>
<a href="#review-jurmy24" title="review">👀</a>
<a href="#research-jurmy24" title="research">🔬</a>
<a href="#tutorial-jurmy24" title="tutorial">✅</a>
<a href="#talk-jurmy24" title="talk">📢</a>
<a href="#userTesting-jurmy24" title="userTesting">📓</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/EssaMohamedali"><img src="https://avatars.githubusercontent.com/u/50261366?v=4?s=100" width="100px;" alt="EssaMohamedali"/>
 EssaMohamedali</a>
 
<a href="#business-EssaMohamedali" title="business">💼</a>
<a href="#content-EssaMohamedali" title="content">🖋</a>
<a href="#eventOrganizing-EssaMohamedali" title="eventOrganizing">📋</a>
<a href="#financial-EssaMohamedali" title="financial">💵</a>
<a href="#fundingFinding-EssaMohamedali" title="fundingFinding">🔍</a>
<a href="#ideas-EssaMohamedali" title="ideas">🤔</a>
<a href="#projectManagement-EssaMohamedali" title="projectManagement">📆</a>
<a href="#promotion-EssaMohamedali" title="promotion">📣</a>
<a href="#talk-EssaMohamedali" title="talk">📢</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/Annagrace1704"><img src="https://avatars.githubusercontent.com/u/180529411?v=4?s=100" width="100px;" alt="Annagrace1704"/>
 Annagrace1704</a>
 
<a href="#content-Annagrace1704" title="content">🖋</a>
<a href="#design-Annagrace1704" title="design">🎨</a>
<a href="#promotion-Annagrace1704" title="promotion">📣</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://book.fredygerman.com"><img src="https://avatars.githubusercontent.com/u/26197540?v=4?s=100" width="100px;" alt="Fredy Mgimba"/>
 Fredy Mgimba</a>
 
<a href="#code-fredygerman" title="code">💻</a>
<a href="#infra-fredygerman" title="infra">🚇</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/alvaro-mazcu"><img src="https://avatars.githubusercontent.com/u/102028776?v=4?s=100" width="100px;" alt="Álvaro Mazcuñán Herreros"/>
 Álvaro Mazcuñán Herreros</a>
 
<a href="#code-alvaro-mazcu" title="code">💻</a>
<a href="#doc-alvaro-mazcu" title="doc">📖</a>
<a href="#test-alvaro-mazcu" title="test">⚠️</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/wjunwei2001"><img src="https://avatars.githubusercontent.com/u/109643278?v=4?s=100" width="100px;" alt="Wang Junwei"/>
 Wang Junwei</a>
 
<a href="#code-wjunwei2001" title="code">💻</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://iamrobzy.github.io/"><img src="https://avatars.githubusercontent.com/u/60611384?v=4?s=100" width="100px;" alt="Robert"/>
 Robert</a>
 
<a href="#code-iamrobzy" title="code">💻</a>
<a href="#ideas-iamrobzy" title="ideas">🤔</a>
<a href="#mentoring-iamrobzy" title="mentoring">🧑‍🏫</a>
<a href="#projectManagement-iamrobzy" title="projectManagement">📆</a>
<a href="#question-iamrobzy" title="question">💬</a>
</td>
 </tr>
 <tr>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/Ben-Temming"><img src="https://avatars.githubusercontent.com/u/91560536?v=4?s=100" width="100px;" alt="Ben-Temming"/>
 Ben-Temming</a>
 
<a href="#code-Ben-Temming" title="code">💻</a>
<a href="#doc-Ben-Temming" title="doc">📖</a>
<a href="#test-Ben-Temming" title="test">⚠️</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/JohanL01"><img src="https://avatars.githubusercontent.com/u/55000709?v=4?s=100" width="100px;" alt="JohanJohanJohan"/>
 JohanJohanJohan</a>
 
<a href="#code-JohanL01" title="code">💻</a>
<a href="#design-JohanL01" title="design">🎨</a>
<a href="#ideas-JohanL01" title="ideas">🤔</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/Silvia-00"><img src="https://avatars.githubusercontent.com/u/144936497?v=4?s=100" width="100px;" alt="Silvia Mosca"/>
 Silvia Mosca</a>
 
<a href="#audio-Silvia-00" title="audio">🔊</a>
<a href="#code-Silvia-00" title="code">💻</a>
<a href="#ideas-Silvia-00" title="ideas">🤔</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/Erikbou"><img src="https://avatars.githubusercontent.com/u/16526330?v=4?s=100" width="100px;" alt="Erik Boustedt "/>
 Erik Boustedt </a>
 
<a href="#code-Erikbou" title="code">💻</a>
<a href="#content-Erikbou" title="content">🖋</a>
<a href="#data-Erikbou" title="data">🔣</a>
<a href="#ideas-Erikbou" title="ideas">🤔</a>
<a href="#financial-Erikbou" title="financial">💵</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/Bhargavvvvvv"><img src="https://github.com/Bhargavvvvvv.png?s=100" width="100px;" alt="Bhargavvvvvv"/>
 Bhargavvvvvv</a>
 
<a href="#code-Bhargavvvvvv" title="code">💻</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/MommeAbbas"><img src="https://github.com/MommeAbbas.png?s=100" width="100px;" alt="MommeAbbas"/>
 MommeAbbas</a>
 
<a href="#code-MommeAbbas" title="code">💻</a>
</td>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/adricalm"><img src="https://github.com/adricalm.png?s=100" width="100px;" alt="adricalm"/>
 adricalm</a>
 
<a href="#code-adricalm" title="code">💻</a>
</td>
 </tr>
 <tr>
 <td align="center" valign="top" width="14.285714285714286%">
<a href="https://github.com/SimonProjekt"><img src="https://avatars.githubusercontent.com/u/192915528?v=4?s=100" width="100px;" alt="SimonProjekt"/>
 SimonProjekt</a>
 
<a href="#bug-SimonProjekt" title="bug">🐛</a>
<a href="#code-SimonProjekt" title="code">💻</a>
<a href="#data-SimonProjekt" title="data">🔣</a>
</td>
 </tr>
 </tbody>
</table>

## 📈 Monitoring

- The FastAPI service now exposes `GET /metrics`, backed by `prometheus-fastapi-instrumentator` and custom counters for WhatsApp webhooks, LLM calls, rate limiting, and generated messages.
- Launch the local Prometheus + Grafana stack with `docker compose -f monitoring/docker-compose.monitoring.yml up`; Prometheus listens on `:9090` and Grafana on `:4000`.
- Prometheus scrapes the Twiga app at `host.docker.internal:8000/metrics` by default—if you run the API elsewhere, edit `monitoring/prometheus/prometheus.yml` accordingly.
- Grafana auto-provisions a Prometheus datasource plus three dashboards (`FastAPI Overview`, `LLM Performance`, `Redis Overview`) from `monitoring/grafana/provisioning`.
- Example alerts (5xx rate, slow latency) ship in `monitoring/prometheus/alerts.yml`.

## 📜 License

twiga

Was this content helpful?

Recent Feedback

Download README