# Project pack: wger @ 48e02bf

Facts about **wger** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> wger is a free fitness diary. Build workout routines from a library of exercises with pictures, log each session, and track your body weight and measurements over time. It also has meal plans and a calorie counter with a large food database from Open Food Facts. Use the free hosted site, or run it on your own computer or server so your health data stays yours. Phone apps for Android and iPhone can connect to either.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. Docker Desktop on Windows may need a computer restart and an admin-only Windows feature (virtualisation); say so and let the person decide.
- Verdict source: https://wger.readthedocs.io
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/wger-project/wger
- Pinned commit: `48e02bfe45e83b87781058261986cda88ff2e6d5`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/wger-project/wger/archive/48e02bfe45e83b87781058261986cda88ff2e6d5.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://wger.readthedocs.io
- Live demo: https://wger.de. The project's own free hosted service with real users, not a throwaway demo. Make a free account to try it. Your data is stored there, so only enter what you're happy to keep on their server.
- Licence: **AGPL-3.0-or-later**. Free to use and change. If you run a changed version that other people use over the internet (not just yourself or your household), you must offer them your source code under the same licence. Exercise and food data has its own Creative Commons licences, shown on each entry.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/wger-project/wger bespoke-wger
  cd bespoke-wger
  git checkout --detach 48e02bfe45e83b87781058261986cda88ff2e6d5
  # Prepare development requirements and local configuration first.
  # Setup notes: http://localhost:8000
  export DJANGO_SETTINGS_MODULE=settings.local_dev && uv sync --group dev && uv run wger bootstrap && uv run python manage.py runserver
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  docker run -ti --name wger.demo -p 8000:80 wger/demo
  # then open http://localhost:8000 and log in as admin / adminadmin.
  # This demo image wipes its data when updated; for real use, follow the docker compose setup in github.com/wger-project/docker
  ```
- Tools these commands use: Docker, or for development Python 3.12+ with uv and Node.js with npm
- Develop: `export DJANGO_SETTINGS_MODULE=settings.local_dev && uv sync --group dev && uv run wger bootstrap && uv run python manage.py runserver   # http://localhost:8000`
- Test: `uv run ./manage.py test --parallel auto`
- Check/lint: `uv run ruff check && uv run ruff format --check`
- Stack: python, javascript, html, scss (Django, Django REST Framework, Bootstrap 5, htmx, React components (@wger-project/react-components)). Difficulty for a non-developer with an AI: **moderate**. A large but conventional Django project split into apps (manager for routines, nutrition, weight, measurements, gallery, gym). Many screens, such as the routine and nutrition editors, come from a separate React package (wger-project/react), so changing them means working in that repository too.
Personal data: **yes**. Stored in: SQLite for the demo and development; PostgreSQL in the recommended docker compose setup. Photos go in the media folder. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/wger/48e02bf/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/wger/48e02bf/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/wger/48e02bf/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/wger/48e02bf/r3/SKILL.md)