# Project pack: LibrePhotos @ 14b4523

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

> LibrePhotos is a self-hosted photo and video manager, an alternative to Google Photos. It scans your folders, groups pictures by people with face recognition, places on a map, events and scenes, and offers search, albums and sharing. It is built for people who want smart features without the cloud.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Download the prebuilt program for your system and run it. No Docker. Windows only; other systems use Docker.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://docs.librephotos.com/docs/installation/windows-standalone
- 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/LibrePhotos/librephotos
- Pinned commit: `14b452385fa390ec2b221c5e335c42498467137a`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/LibrePhotos/librephotos/archive/14b452385fa390ec2b221c5e335c42498467137a.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.librephotos.com
- Licence: **MIT**. Free to use, change and share, even commercially. Keep the original copyright notice.

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

  ```sh
  git clone https://github.com/LibrePhotos/librephotos bespoke-librephotos
  cd bespoke-librephotos
  git checkout --detach 14b452385fa390ec2b221c5e335c42498467137a
  # Prepare development requirements and local configuration first.
  cd apps/frontend
  npm install
  npm run dev
  ```

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

  ```sh
  Follow the installation guide at https://docs.librephotos.com/installation/standard-install, which provides a docker-compose.yml with the librephotos images.
  ```
- Tools these commands use: Docker with 8 GB or more of memory and a lot of disk space; Python and Node for development
- Develop: `cd apps/frontend && npm run dev`
- Stack: python, typescript (Django, Django REST Framework, React, Vite, Docker). Difficulty for a non-developer with an AI: **advanced**. A Django back end with machine-learning jobs and a React front end, plus docs and a mobile app in the same repository. Library settings are easy; changes to the pipeline are heavy.
- The project's own AI instructions, in the repository: `AGENTS.md`, `CLAUDE.md`.
Personal data: **yes**. Stored in: A Postgres database plus a cache of thumbnails and models; your originals stay in your photo folder. Secrets are entered by the person, never in chat.

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