Sensible is a gentle, data-informed wellbeing assistant. It blends biometric signals, manual check-ins, optional external data, and empathetic coaching to predict mood/energy/stress trends and suggest supportive next steps.

Deployed live at https://thesensiblecoach.tech.

Note: This is not medical advice. It is a personal wellness tool and demo architecture.

Sensible is a web application designed to predict mood and energy levels and provide personalized insights based on user logs and environmental context. During onboarding, users complete a brief questionnaire to collect basic information and establish an initial baseline. After creating an account, users gain access to a comprehensive dashboard featuring predictions, recommendations, trends, logging tools, and more.

Key features include:

• Mood and energy predictions with up to a 2-day forecast
• Integration of weather and environmental context data
• AI-powered lifestyle recommendations tailored to user patterns
• User feedback collection to improve predictions and insights
• Phone notifications that remind users to log their data

Frontend

• React with Vite for fast development and optimized builds
• React Router for client-side routing
• Material UI for modern, responsive UI components

Backend

• Python FastAPI for scalable API endpoints
• MongoDB for storing biometrics, manual user logs, user feedback, profiles, and more

External Integrations

• Snowflake API and Open Weather API for weather context
• Google Gemini API for AI-powered predictions and insights
• ntfy for phone notifications

• backend/ -> API + inference + integrations
• frontend/ -> React UI
• data/processed/ -> local JSONL storage
• scripts/ -> operational scripts
• docs/PROJECT_UNITS.md -> full unit breakdown and dev flow

• Auth: /api/auth/register, /api/auth/login, /api/auth/logout, /api/auth/session
• Health import: /api/import/healthkit or /api/health/import
• Logs: /api/mood, /api/daily-log, /api/activity, /api/symptom
• Predictions: /api/predictions, /api/suggestions, /api/alerts
• Settings & profile: /api/settings, /api/profile
• Feedback: /api/feedback
• Notifications: /api/notify
• Status: /api/status, /api/freshness

1. Python setup

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Frontend setup

npm --prefix frontend install

3. Optional: bootstrap demo data

./scripts/bootstrap.sh

4. Run API + UI

./scripts/start_all.sh

API runs on http://localhost:8088 and UI on http://localhost:8090 by default.