pip install matercare-homes

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")

# Run API
matercare-api

# Or programmatically
from matercare.src.api import app
import uvicorn
uvicorn.run(app, port=8000)

# Run MCP server
matercare-mcp

# Now connect Claude Code, Cursor, etc.

┌─────────────────────────────────────────────────────────────────┐
│                    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    │    │
│   └─────────────────────────────────────────────────────┘    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

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"}
))

# Chat
curl -X POST http://localhost:8000/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Fall prevention tips"}'

# Care plan
curl -X POST http://localhost:8000/care-plan \
  -H "Content-Type: application/json" \
  -d '{"patient_name": "John", "conditions": ["diabetes"], "mobility": "ambulatory", "cognitive_status": "alert"}'

# Sensors
curl http://localhost:8000/sensors/status

from matercare import KnowledgeBase, KnowledgeSource

kb = KnowledgeBase()
kb.add_source(KnowledgeSource(
    name="Custom Hospital Protocol",
    content="Our emergency protocol for...",
    source_type="manual"
))

from matercare.src.orchestration import MaterCareOrchestrator
from matercare.src.orchestration.agents import get_care_agent

# Create orchestrator
orchestrator = MaterCareOrchestrator()

# Register care agents
orchestrator.register_agent("triage_agent", get_care_agent("triage"))
orchestrator.register_agent("medication_agent", get_care_agent("medication"))
orchestrator.register_agent("emergency_agent", get_care_agent("emergency"))
orchestrator.register_agent("vital_agent", get_care_agent("vital"))
orchestrator.register_agent("cognitive_agent", get_care_agent("cognitive"))

# Execute care loop
result = await orchestrator.care_loop("senior_123", {
    "sensors": {
        "motion": True,
        "fall": False,
        "heart_rate": 72,
        "temperature": 36.5
    },
    "voice": "I'm feeling tired today"
})

print(f"Priority: {result.priority}")
print(f"Recommendation: {result.recommendation}")
print(f"Actions: {result.actions}")

# Run MCP server
python -m matercare.src.orchestration.mcp_server

# Or run directly
python matercare/src/orchestration/mcp_server.py

from matercare.src.orchestration.integrations import create_connector

# Create connector to TAURUS MCPs
connector = await create_connector()

# Use MCP bridge for eldercare-specific operations
bridge = MaterCareMCPBridge(connector)

# Notify family via email, SMS, WhatsApp, Slack
await bridge.notify_family(
    senior_name="John Smith",
    message="Fall detected - please check in",
    priority="urgent",
    channels=["email", "sms", "whatsapp"]
)

# Schedule caregiver visit
from datetime import datetime
await bridge.schedule_caregiver_visit(
    senior_name="John Smith",
    caregiver_name="Mary",
    scheduled_time=datetime(2026, 2, 28, 10, 0),
    notes="Regular wellness check"
)

# Install
pip install matercare-homes

# Run sensor gateway
python -m matercare.sensors.gateway --senior-id "dad"

# .env
MATERCARE_MODEL=Taurus-AI-Corp/matercare-llama-3.2-3b
HUGGINGFACE_API_TOKEN=your_token
TWILIO_ACCOUNT_SID=your_sid
TWILIO_AUTH_TOKEN=your_token
TWILIO_PHONE_NUMBER=+1234567890
ALERT_PHONE_NUMBER=+0987654321
DATABASE_URL=postgresql://...