Wellness Coach#

Spin up a personalized Baymax wellness coach video session from health + calendar data.

What This Skill Does#

1. Reads wearable health data (mock or real: Oura/Fitbit/Apple Health)
2. Fetches today's Google Calendar events
3. Calls Claude to generate a Baymax system prompt + wellness recommendations
4. Creates a live Tavus CVI session (interactive video avatar)
5. Optionally delivers a Telegram morning briefing with the session link

Project Setup#

bash

git clone https://github.com/AndreChuabio/wellness-coach
cd wellness-coach
pip install -r backend/requirements.txt
cp .env.example .env  # fill in API keys

Required API Keys (.env)#

text

ANTHROPIC_API_KEY=       # Claude context generation
TAVUS_API_KEY=           # Tavus CVI sessions
TAVUS_REPLICA_ID=        # Avatar replica (platform.tavus.io → Replicas)
TAVUS_PERSONA_ID=        # Baymax persona (platform.tavus.io → Personas)

Running the Backend#

bash

cd backend
uvicorn main:app --reload
# Swagger UI: http://localhost:8000/docs

Running the Frontend#

bash

cd frontend
python3 -m http.server 3000
# Open: http://localhost:3000

Key Endpoints#

MethodPathWhat it doesGET``/health-dataToday's wearable metricsGET``/calendarToday's calendar eventsPOST``/start-sessionFull pipeline → Tavus CVI URL + recsGET``/debug-envCheck all API keys are loaded

Morning Briefing Pipeline (Telegram)#

Run both scripts back-to-back — always together so the Tavus link is fresh:

bash

python3 cron/morning_context.py && python3 cron/send_briefing.py

This builds context, pre-warms a Tavus session, and sends a Telegram message with:

• Sleep score, HRV, recovery score
• Today's calendar summary
• Top wellness recommendation
• Live Tavus session link (valid ~10 min after creation)

Automated Daily Cron (OpenClaw)#

Register a 7AM daily cron via OpenClaw to automate the morning briefing. See references/openclaw-cron.md for the exact setup.

Connecting Real Wearable Data#

See references/wearables.md for Oura, Fitbit, and Apple Health integration guides.

Google Calendar Integration#

See references/gcal-setup.md for OAuth setup to get real calendar events.

Wellness Recommendations Logic#

Recommendations are generated in backend/context_builder.py based on:

SignalTriggerSuggestionHRV < 50msbelow avgBox breathing, recovery daySleep score < 75poor sleepNap window, caffeine cutoffHigh-stakes meetingkeyword match4-7-8 breathing beforehand4+ meetingspacked dayMicro-meditations between meetingsRecovery ≥ 80 + HRV ≥ avggreat dayPush harder, workout, cold exposure

Knowledge Base (Tavus Persona)#

Upload wellness content directly to the Tavus Persona via: platform.tavus.io → Personas → Your Persona → Knowledge Base → Add Files

Format files as structured scripts:

text

# [Exercise Name]
## When to use
## Script (word-for-word guide)
## Duration

Tavus Persona Settings#

• LLM: tavus-gpt-oss (or custom Claude endpoint)
• STT: tavus-advanced
• TTS: Tavus Default
• Hotwords: HRV, Baymax, meditation, breathing, recovery
• Turn detection: Sparrow-1 (user mutes mic to trigger response)

Common Issues#

Avatar nods but doesn't speak → Mic permission not granted. Click lock icon in browser → allow microphone → rejoin.

Mock mode despite keys set → .env not loading. Run /debug-env to verify. Ensure .env is in project root, not backend/.

Tavus link expired → Sessions last ~10 min. Always run morning_context.py and send_briefing.py together right before use.

GCal shows mock data → Set GOOGLE_CREDENTIALS_PATH and GOOGLE_TOKEN_PATH in .env. Run python3 setup_gcal.py once to authorize.