Advanced hypertrophy tracker with 3D muscle heatmap, AI coach (Groq gpt-oss-120b), weekly planner, workout logger, nutrition counter, Technogym equipment catalog, and Apple Health import.
brew install direnv uv pnpm docker
cp .envrc.local.example .envrc.local # fill GROQ_API_KEY
direnv allow # loads env + starts postgres/redis/minio
make dev # api + worker + web- Web: http://localhost:3000
- API: http://localhost:8000/docs
- MinIO console: http://localhost:9001
Monorepo: apps/web (Next.js 15), apps/api (FastAPI hexagonal), packages/shared (zod schemas).
Backend follows hexagonal + clean architecture with pure-function use cases in application/, domain models in domain/, and adapters at the edges.
| Target | Description |
|---|---|
make dev |
Infra + API + worker + web |
make test |
pytest + vitest |
make db.migrate |
Alembic upgrade |
make db.seed |
Load Technogym, exercises, programs |
make openapi |
Regenerate TS types from OpenAPI |
See make help for the full list.
All env vars via direnv (.envrc + .envrc.local). See .envrc.local.example.
make test # unit tests
make e2e # Playwright (requires running stack)