# LibrePhotos

> LibrePhotos (8.1k stars, 1.3.0 Oct 2026) scans your photo folders and uploads from its web and Expo mobile apps, then adds face detection and clustering, object tags, generated captions, semantic search, a timeline by day and place, a map, event albums, shared albums and public links. Code is MIT, but face detection uses InsightFace, whose pretrained models are non-commercial research only. Needs 4 GB RAM and 2 cores (8 GB recommended for ML). Runs as a single container, Docker Compose, Kubernetes or a Windows standalone build. Automatic phone backup is not documented.

- Repository: https://github.com/LibrePhotos/librephotos
- Official docs: https://docs.librephotos.com/docs/installation/
- Checked: 2026-10-16

## What it replaces
- Google Photos: Search photos by faces, Shared albums and links, Timeline and map browsing (partial). Search, sharing and timeline/map; background phone backup is not documented.

## Facts, with sources

| Question | Status | Answer | Source | Checked |
|---|---|---|---|---|
| Runs on my machine? | Confirmed | Self-hosted (Docker, Compose, Kubernetes, Unraid) or Windows standalone | https://github.com/LibrePhotos/librephotos#installation | 2026-10-16 |
| Code licence | Confirmed | MIT | https://github.com/LibrePhotos/librephotos/blob/dev/LICENSE | 2026-10-16 |
| Model weights licence | No | Face detection uses InsightFace, whose pretrained models are non-commercial research only; captioning uses LFM2.5-VL (LFM licence); OpenCLIP is MIT | https://github.com/deepinsight/insightface#license | 2026-10-16 |
| Commercial use | No | MIT code, but the InsightFace face models it relies on are non-commercial | https://github.com/deepinsight/insightface#license | 2026-10-16 |
| Paid services needed? | Confirmed | None | https://github.com/LibrePhotos/librephotos#readme | 2026-10-16 |
| Hardware | Confirmed | Minimum 4 GB RAM, 2 cores, 10 GB storage plus library; 8 GB+ RAM recommended for ML | https://github.com/LibrePhotos/librephotos#system-requirements | 2026-10-16 |
| Operating systems | Confirmed | Any Docker-compatible OS (Linux recommended) or Windows standalone; Android and iOS app | https://github.com/LibrePhotos/librephotos#system-requirements | 2026-10-16 |
| Setup effort | Confirmed | Medium; single Docker container recommended, or Compose with optional NVIDIA GPU | https://github.com/LibrePhotos/librephotos#installation | 2026-10-16 |

GitHub: 8104 stars, 411 forks, last push 2026-10-16, archived: no.
---
Source: RepoQuarry (https://repoquarry.dev/projects/librephotos). Data licence: CC BY 4.0. Quotes are from project documentation and belong to their authors.