README.md
Passive monitoring for elderly that informs caregivers.
MaterCare Homes
The "Grandma Test" passed - No smartphone required. Passive monitoring for elderly that informs caregivers.
What is MaterCare Homes?
MaterCare Homes is an AI-powered eldercare platform designed for the 80% of seniors who don't use smartphones. It combines:
- 🤖 Agentic AI - Autonomous decision-making for eldercare
- 📄 OCR - Scan prescriptions, medical documents
- 📚 RAG - Healthcare knowledge retrieval
- 📡 IoT Sensors - Passive monitoring (mmWave, PIR, door sensors)
- 🔔 Alerts - SMS/call to caregivers
The Problem We Solve
| Traditional Eldercare Tech | MaterCare |
|---|---|
| Senior needs smartphone | Senior does NOTHING |
| Wearable required | Passive sensors |
| App complexity | Caregiver uses app |
| Reactive alerts | Proactive detection |
| Cloud-only | Edge processing |
Features
1. AI Assistant
- Fine-tuned Llama for eldercare
- Answers: dementia, fall prevention, medications, nutrition
- Available via: API, MCP, Voice (Alexa/Google Home)
2. Care Plan Generator
- Personalized plans based on conditions
- Daily routines, medications, safety
- Emergency protocols
3. Passive Monitoring
- mmWave Radar - Fall detection, vital signs
- PIR Motion - Activity levels
- Door Sensors - Wandering detection
- Pressure Mats - Bed/chair occupancy
4. Alert System
- Real-time SMS/call to caregivers
- Severity-based routing
- Escalation protocols
5. Knowledge Base
- CDC, NIH guidelines
- Drug interactions
- Emergency protocols
- Custom source addition
Quick Start
Installation
pip install matercare-homes
Python Usage
from matercare import MaterCareLLM, SensorGateway, KnowledgeBase
# Chat with eldercare AI
llm = MaterCareLLM()
response = llm.chat("What are signs of dehydration in elderly?")
print(response)
# Set up sensors
gateway = SensorGateway("senior_01")
gateway.register_sensor("mmwave_01", "mmwave")
gateway.register_sensor("door_01", "door")
# Query knowledge base
kb = KnowledgeBase()
results = kb.retrieve("fall prevention")
API Server
# Run API
matercare-api
# Or programmatically
from matercare.src.api import app
import uvicorn
uvicorn.run(app, port=8000)
MCP Server (For AI Agents)
# Run MCP server
matercare-mcp
# Now connect Claude Code, Cursor, etc.
Architecture
┌─────────────────────────────────────────────────────────────────┐
│ MATERCARE HOMES │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ PASSIVE │ │ AGENTIC │ │ ALERT │ │
│ │ SENSORS │────▶│ AI CORE │────▶│ SYSTEM │ │
│ │ │ │ │ │ │ │
│ │ • mmWave │ │ • OCR │ │ • SMS │ │
│ │ • Motion │ │ • RAG │ │ • Call │ │
│ │ • Door │ │ • LLM │ │ • Push │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ MCP CONNECTOR (Plug & Play) │ │
│ │ • Claude Code • Cursor • Copilot • CrewAI │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Integration
Connect to Any AI Agent
from matercare.src.mcp import MaterCareMCP, MCPRequest
mcp = MaterCareMCP()
# Works with Claude Code, Cursor, Copilot, etc.
response = mcp.handle(MCPRequest(
method="chat",
params={"message": "Elder care advice"}
))
REST API
Tools (3)
chatInteract with the fine-tuned eldercare AI for advice on dementia, fall prevention, medications, and nutrition.register_sensorRegister a passive sensor like mmWave, PIR, or door sensor to a senior's profile.retrieve_knowledgeQuery the healthcare knowledge base for guidelines on fall prevention, drug interactions, or emergency protocols.Configuration
claude_desktop_config.json
{"mcpServers": {"matercare": {"command": "matercare-mcp"}}}Try it
→What are the common signs of dehydration in the elderly that I should look out for?
→Create a daily care plan for a senior with dementia focusing on nutrition and safety.
→Retrieve the latest CDC guidelines for fall prevention in home environments.
→Register a new mmWave sensor with ID mmwave_01 for the current senior profile.