Kettleworth

A coach in your pocket: personalised training, nutrition and recovery that adapt to what you actually do. Web first (PWA), mobile next. See docs/BRIEF.md for the architecture and design brief, docs/EVIDENCE.md for the research behind every engine rule, and docs/CASE-STUDIES.md (generated by the core test suite) for six worked plans.

Run locally

cp .env.example .env            # then set BETTER_AUTH_SECRET and HEALTH_DATA_ENCRYPTION_KEY (openssl rand -base64 32)
docker compose up -d            # Postgres on 5434, Redis on 6380
pnpm install
pnpm db:migrate && pnpm db:seed # 855 exercises, 46 recipes
pnpm dev                        # http://localhost:3000

Optional: YOUTUBE_API_KEY plus pnpm --filter @kettleworth/db exec tsx scripts/find-youtube.ts fills the library with embedded YouTube demonstrations from an allowlist of coaching channels; MUX_TOKEN_ID/SECRET plus scripts/upload-videos.ts attaches original footage. ANTHROPIC_API_KEY turns on the AI coach (follow-up questions, summaries, coach notes). Without it the product runs fully on the deterministic engine with templated copy. Provider client IDs (Oura, Whoop, Strava, Fitbit, Garmin, Polar) enable each Connected App.

Scripts

pnpm test (Vitest, core + integrations) · pnpm typecheck · pnpm test:e2e (Playwright) · pnpm db:studio.