# Project pack: PhotoPrism @ 1c515fd

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

> PhotoPrism turns a folder of family photos and videos into a private photo library you open in the browser. It sorts pictures by date and place, recognises faces and things like "beach" or "dog", and shows your trips on a world map. Share albums with relatives by link, and back up phones with a sync app. It runs on your own computer or NAS, so your pictures never go to a big tech company.

## 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://docs.photoprism.app
- 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/photoprism/photoprism
- Pinned commit: `1c515fd6a6e89d917ccc318a96c8cc39ee8c4d8f`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/photoprism/photoprism/archive/1c515fd6a6e89d917ccc318a96c8cc39ee8c4d8f.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://docs.photoprism.app
- Live demo: https://try.photoprism.app. Official public demo. Don't upload anything private.
- Licence: **AGPL-3.0-only**. Free to use and change. If you run a changed version that other people use over the internet (not just your own household), you must offer them your source code under the same licence. "PhotoPrism" and its logo are registered trademarks: a changed copy you share must not use the brand. Some extras are only for paying members.

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

  ```sh
  git clone https://github.com/photoprism/photoprism bespoke-photoprism
  cd bespoke-photoprism
  git checkout --detach 1c515fd6a6e89d917ccc318a96c8cc39ee8c4d8f
  # Prepare development requirements and local configuration first.
  # Setup notes: then inside the container: make dep build-js build-go && ./photoprism start
  make docker-build && docker compose up -d && make terminal
  ```

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

  ```sh
  mkdir photoprism && cd photoprism
  curl -fsSL -o compose.yaml https://dl.photoprism.app/docker/compose.yaml
  # edit compose.yaml first: change PHOTOPRISM_ADMIN_PASSWORD and the database passwords,
  # and point the originals volume at your photo folder
  docker compose up -d
  # then open http://localhost:2342
  ```
- Tools these commands use: Docker with Docker Compose (64-bit Intel, AMD or ARM, including Raspberry Pi 4/5), At least 2 CPU cores and 3 GB RAM (more for large libraries and face recognition), For development, Docker plus the repo's Makefile (Go and Node run inside the dev container)
- Develop: `make docker-build && docker compose up -d && make terminal   # then inside the container: make dep build-js build-go && ./photoprism start`
- Test: `make test-js test-go`
- Check/lint: `make lint-js lint-go`
- Stack: go, javascript, vue (Gin, GORM, Vue 3, Vuetify 3, TensorFlow and ONNX (local AI), FFmpeg, libvips). Difficulty for a non-developer with an AI: **advanced**. Settings, themes, wallpaper, sharing and the AI models are easy to change without code. The code is a large Go backend with a Vue 3 frontend, a Docker-based development environment and many build steps (models, FFmpeg, image libraries). Detailed AGENTS.md files and code maps help an AI find its way.
- The project's own AI instructions, in the repository: `AGENTS.md`, `CODEMAP.md`, `frontend/AGENTS.md`, `frontend/CODEMAP.md`, `.claude/CLAUDE.md`.
Personal data: **yes**. Stored in: Your original photos stay in your own folder (originals volume). Thumbnails, sidecar files, settings and the SQLite option live in the storage volume; the index of albums, people and labels is in MariaDB (database volume). Secrets are entered by the person, never in chat.

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