Stanley03-arch/kiswahili-voice-agent-toolkit

Open-source toolkit for building voice agents that speak and understand Kiswahili and other African languages. Powered by LLMs + LangChain. # Kiswahili Voice Agent Toolkit 🌍🎤 **Build powerful voice & text agents that speak and understand Kiswahili.** Open-source toolkit for creating real agentic applications for East Africa and beyond. Now with **LangGraph**, **tool calling**, **multi-provider support**, and a beautiful **web demo**. --- ## ✨ What's New (Powerful Mode) - **LangGraph orchestration** — proper agent loops with tool calling - **Real tools** out of the box: - Hali ya hewa (weather) — any city - Muda wa sasa (current time) - Hesabu (calculator) - **Multi-provider**: Groq (fast & cheap) or OpenAI - **5 specialized agents**: General, Farm Advisor, Customer Support, Education Tutor, Health Info - **Beautiful Gradio web interface** - Clean, production-ready structure ## Quick Start ```bash git clone github.com cd kiswahili-voice-agent-toolkit python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt cp .env.example .env # Add GROQ_API_KEY or OPENAI_API_KEY ``` ### Run the CLI agent ```bash python examples/basic_kiswahili_agent.py ``` ### Run the powerful demo ```bash python examples/powerful_demo.py ``` ### Launch the Web UI ```bash python web/app.py ``` Then open localhost ## Project Structure ``` kiswahili-voice-agent-toolkit/ ├── agents/ │ └── base_agent.py # LangGraph-powered agent ├── prompts/ │ └── kiswahili_system.py # High-quality role prompts ├── tools/ │ └── common_tools.py # Weather, time, calculator... ├── examples/ │ ├── basic_kiswahili_agent.py │ ├── farm_advisor.py │ └── powerful_demo.py ├── web/ │ └── app.py # Gradio interface ├── requirements.txt └── README.md ``` ## Example Capabilities | Feature | Example Prompt | Result | |---------------------------|-----------------------------------------|--------------------------- …