A hybrid offline/online mental health chatbot for underserved communities in Kenya.
# MindMate AI 🧠
A hybrid offline/online mental health chatbot for underserved communities in Kenya.
## About
MindMate AI provides free, private, and always-available mental health support via text. It works offline using rule-based CBT responses and switches to Gemini AI when internet is available.
## Features
- CBT-based responses in English and Swahili
- Crisis detection with automatic escalation to Kenyan helplines
- Hybrid offline/online mode switching
- SMS support for feature phones (via Africa's Talking)
## Installation
1. Clone the repository:
git clone
github.com
2. Install dependencies:
pip install -r requirements.txt
3. Add your Gemini API key in a .env file:
GEMINI_API_KEY=your_key_here
4. Run the chatbot:
python main.py
## Crisis Support
If you or someone you know is in crisis, contact:
- Befrienders Kenya: 0800 723 253 (free, 24/7)
- Mathare Hospital: 0800 120 320
## Author
Lynette Esther Wangui | BSc Computer Science | Karatina University