# Project pack: Yamtrack @ 2d82621

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

> Yamtrack is a self-hosted media tracker. You add movies, TV shows, anime, manga, books, games and comics, rate them, record progress and see a calendar of upcoming releases. It can import from Trakt, MyAnimeList, AniList, Simkl and others and has lists, statistics and notifications.

## 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://raw.githubusercontent.com/FuzzyGrim/Yamtrack/HEAD/README.md
- 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/FuzzyGrim/Yamtrack
- Pinned commit: `2d826214c0fe0785ac06a2e82c66a30f17d44956`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/FuzzyGrim/Yamtrack/archive/2d826214c0fe0785ac06a2e82c66a30f17d44956.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://github.com/FuzzyGrim/Yamtrack/tree/dev/docs
- Live demo: https://github.com/FuzzyGrim/Yamtrack?tab=readme-ov-file#demo. See the project README for the demo link and sign-in.
- Licence: **AGPL-3.0-only**. Free to use and change. If other people use your changed version, including over a network (for example a website you host for them), you must offer them your source code under the same licence. Using it privately for yourself or your household has no extra obligations.

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

  ```sh
  git clone https://github.com/FuzzyGrim/Yamtrack bespoke-yamtrack
  cd bespoke-yamtrack
  git checkout --detach 2d826214c0fe0785ac06a2e82c66a30f17d44956
  # Prepare development requirements and local configuration first.
  cd src
  pip install -r ../requirements.txt
  python manage.py migrate
  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 -d --name yamtrack -p 8000:8000 -v yamtrack-db:/yamtrack/db -e SECRET=replace-with-a-long-random-string ghcr.io/fuzzygrim/yamtrack
  # then open http://localhost:8000
  ```
- Tools these commands use: Docker for a trial, Python 3.12 for development
- Develop: `cd src && python manage.py runserver`
- Test: `cd src && python manage.py test`
- Stack: python, javascript (Django, HTMX, Tailwind, Celery). Difficulty for a non-developer with an AI: **moderate**. A Django project with one app per media area. Adding a data provider or a statistic follows existing patterns.
Personal data: **yes**. Stored in: A SQLite database in /yamtrack/db (or Postgres). Secrets are entered by the person, never in chat.

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