59 lines
1.7 KiB
Markdown
59 lines
1.7 KiB
Markdown
# Fitness Web
|
|
|
|
Multi-user fitness tracking web app with AI coaching.
|
|
|
|
Track workouts, log daily check-ins, explore exercise history, and chat with an AI coach powered by opencode.
|
|
|
|
## Features
|
|
|
|
- **Workouts** — Plan and log workouts with set-level detail (reps, weight, RPE)
|
|
- **Exercises** — Catalog with body-part filtering and history
|
|
- **Check-ins** — Daily weight, calories, steps, sleep tracking
|
|
- **AI Coach** — Chat interface backed by opencode (Big Pickle model, free)
|
|
- **Multi-user** — Login-based, each user has independent data
|
|
- **Calendar view** — See your training history at a glance
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Install dependencies
|
|
uv sync
|
|
|
|
# Initialize and seed the database
|
|
uv run python scripts/schema.py
|
|
uv run python scripts/seed.py
|
|
|
|
# Start the dev server
|
|
uv run uvicorn app.main:app --reload
|
|
```
|
|
|
|
Open http://localhost:8000, register a user, and you're ready.
|
|
|
|
## Docker
|
|
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
## Architecture
|
|
|
|
```
|
|
app/
|
|
├── main.py — FastAPI app factory with lifespan
|
|
├── config.py — Settings from environment
|
|
├── auth.py — Auth helpers (hash, verify, session)
|
|
├── models/ — SQLAlchemy ORM models
|
|
├── routers/ — Route handlers per feature
|
|
├── services/ — External service integrations (opencode)
|
|
├── templates/ — Jinja2 templates (Pico.css)
|
|
└── static/ — CSS overrides
|
|
scripts/
|
|
├── schema.py — DB table creation
|
|
└── seed.py — Seed exercises and phases
|
|
data/ — SQLite database (gitignored)
|
|
```
|
|
|
|
## Related
|
|
|
|
- [fitness-agent](https://github.com/yourname/fitness-agent) — Original training repo with markdown logs and Juggernaut history. This web app replaces it.
|