scot/diligence
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Diligence — self-hosted fitness rewards platform with AI coaching. Open-source, MIT licensed.
37 commits 1 branch 0 tags 814 KiB
Find a file
Claude c133a463ec Deliver Step 9: agent-card.json, SKILL.md, USDA lookup, integrations dynamic config, Welcome/Integrations/MealPlan pages, API methods, README, routes
2026-06-15 14:40:34 +00:00
backend Deliver Step 9: agent-card.json, SKILL.md, USDA lookup, integrations dynamic config, Welcome/Integrations/MealPlan pages, API methods, README, routes 2026-06-15 14:40:34 +00:00
content Add 3-day fast operational protocol (hour-by-hour) 2026-04-16 15:16:24 +00:00
frontend Deliver Step 9: agent-card.json, SKILL.md, USDA lookup, integrations dynamic config, Welcome/Integrations/MealPlan pages, API methods, README, routes 2026-06-15 14:40:34 +00:00
mcp-connector Deliver Steps 3-8: integration config, meal plans, provider registry, MCP connector (14 tools), B2A files, nginx proxy, AGENT_GUIDE, LICENSE 2026-06-15 14:34:09 +00:00
.env.example Deliver Step 1: Backend cleanup — secrets scrubbed, is_admin column, Telegram optional, crypto service, v4-v7 migrations, .env.example, setup.sh 2026-06-15 14:29:53 +00:00
.gitignore Deliver Step 1: Backend cleanup — secrets scrubbed, is_admin column, Telegram optional, crypto service, v4-v7 migrations, .env.example, setup.sh 2026-06-15 14:29:53 +00:00
AGENT_GUIDE.md Deliver Steps 3-8: integration config, meal plans, provider registry, MCP connector (14 tools), B2A files, nginx proxy, AGENT_GUIDE, LICENSE 2026-06-15 14:34:09 +00:00
docker-compose.yml Deliver Step 1: Backend cleanup — secrets scrubbed, is_admin column, Telegram optional, crypto service, v4-v7 migrations, .env.example, setup.sh 2026-06-15 14:29:53 +00:00
LICENSE Deliver Steps 3-8: integration config, meal plans, provider registry, MCP connector (14 tools), B2A files, nginx proxy, AGENT_GUIDE, LICENSE 2026-06-15 14:34:09 +00:00
README.md Deliver Step 9: agent-card.json, SKILL.md, USDA lookup, integrations dynamic config, Welcome/Integrations/MealPlan pages, API methods, README, routes 2026-06-15 14:40:34 +00:00
setup.sh Deliver Step 1: Backend cleanup — secrets scrubbed, is_admin column, Telegram optional, crypto service, v4-v7 migrations, .env.example, setup.sh 2026-06-15 14:29:53 +00:00

README.md

Diligence — Self-Hosted Fitness Rewards with AI Agent Support

Points-based fitness accountability app. Log workouts and food, earn points, unlock rewards. Connect any AI agent via MCP for logging, coaching, and meal planning. Self-hosted, open source, zero cloud dependencies.

Built by DiligenceWorks.

Quick Start

git clone https://github.com/diligenceworks/diligence
cd diligence
./setup.sh
docker compose up -d

Open http://localhost and create your account.

Features

  • Points economy — earn from workouts, food logging, step goals. Daily gate locks rewards until you earn enough. Weekly reset.
  • Science-based onboarding — PAR-Q+ safety screening, TTM stages of change, BREQ-2 motivation profiling.
  • AI agent integration — 14 MCP tools for logging, coaching, meal planning, and device configuration.
  • Meal plans — AI-generated plans with compliance tracking and points integration.
  • Activity sync — Strava, Polar (OAuth 2.0). Garmin, Fitbit, Withings, WHOOP, Oura configurable in-app.
  • Food search — Open Food Facts (4M+ products) + USDA FoodData Central (400K+ research-grade).
  • Program tracking — 90-day structured programs (StrongLifts, Darebee, etc.) with day-by-day progression.
  • Configurable rewards — you define what's worth earning. Gaming time, screen time, treats — your rules.

Connecting an AI Agent

Point your agent's MCP config to http://localhost:3001/sse (development) or https://your-domain/mcp (production behind reverse proxy).

Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible agent.

Copy the contents of AGENT_GUIDE.md into your agent's system instructions for motivation-aware coaching.

Configuring Integrations

All integrations are configured through the app UI (Settings → Integrations) or through your AI agent. No .env file editing or container restarts needed.

Data Sovereignty

Diligence is self-hosted software. Your data never leaves your server. No cloud dependency, no vendor lock-in, no telemetry. MIT license — fork it, modify it, keep it forever.

Your fitness data — heart rate, body composition, food intake, GPS traces — is biometric data that deserves sovereignty.

Stack

  • Python 3.12, FastAPI, SQLAlchemy
  • React 18, Vite
  • PostgreSQL 16
  • FastMCP (Streamable HTTP/SSE)
  • Docker Compose

Contributing

Contributions welcome. Open an issue to discuss before submitting a PR.

License

MIT — see LICENSE.