Bridging the care gap for Kenya's rural elderly through localized, voice-first technology.
# M-Kumbusha - Healthcare Reminder & Caregiver Support Platform
Live Demo:
m-kumbusha.onrender.com
A comprehensive multi-channel healthcare reminder and caregiver support platform designed for elderly care in rural Africa. Supports both feature phone users (via SMS and voice calls) and smartphone users (via web dashboard).
---
## 🚀 Quick Start
### 1. First Time Setup
**Register an Account:**
1. Open the application
2. Click "Register"
3. Create a username and password
4. The first user automatically becomes an admin
**Configure SMS/Voice (Required):**
1. Sign up at africastalking.com (free sandbox available)
2. Get your API Key and Username from the dashboard
3. Enter credentials when prompted in the application
4. For sandbox: Register test phone numbers in Africa's Talking dashboard
📖 **Full setup guide:** SMS_SETUP_GUIDE.md
---
## 📱 Features
### For Caregivers:
- **Dashboard**: Overview of all elderly people, schedules, and reminder statistics
- **AI Care Assistant**: Chat with Gemini AI for healthcare guidance and medication advice
- **Trend Analytics**: Visualize 7-day adherence patterns with interactive charts
- **Elderly Management**: Add and manage elderly people with medical conditions and contacts
- **Reminder Scheduling**: Create automated reminders for medications, exercise, and appointments
- **Magic Voice Scripts**: Automatically generate personalized, comforting voice scripts via AI
- **Automatic Escalation**: Alerts secondary contacts when reminders are missed
- **Multi-Channel**: Send via SMS, voice calls, or both
- **Multi-Language**: Support for English and Kiswahili
### For Admins:
- **User Management**: View all users and manage roles
- **System Monitoring**: Track reminder success rates and system usage
---
## 📋 User Guide
### Adding an Elderly Person:
1. Go to **Elderly Care** page
2. Click **Add Elderly Person**
3. Fill in details and click **Save**
### Creating a Reminder Schedule:
1. Go to **Schedules** page
2. Clic …