← all repositories
LibrePhotos/librephotos

Your photos stay home; the machine learning moves in

LibrePhotos lets you hoard photos on your own server and find that blurry shot from "Thursday in Berlin" without feeding the cloud.

8k stars Python Domain Apps
librephotos
Not currently ranked — collecting fresh signals.
star history

What it does

LibrePhotos is a self-hosted photo and video archive that scans your filesystem, extracts EXIF data, and builds a browsable timeline. It runs face recognition, scene detection, and semantic search locally using models like places365 and im2txt, then serves everything through a React frontend with MapLibre maps. Multi-user support means your whole household can share the same instance without sharing accounts.

The interesting bit

The project recently swallowed five separate repositories—backend, frontend, mobile app, docs, and deployment configs—into one monorepo while preserving the full commit history. That administrative feat is almost as impressive as the ML pipeline, and it suggests the maintainers are serious about long-term hygiene rather than just duct-taping containers together.

Key highlights

  • Supports RAW photos and videos, not just JPEGs, with ImageMagick and FFmpeg handling conversions
  • Generates event-based albums like “Thursday in Berlin” from reverse geocoding and timestamps
  • ML stack includes face_recognition, hdbscan clustering, and semantic captioning, but the README warns you’ll want 8 GB+ RAM for smooth operation
  • Ships with a React Native Android client, Django 5 API, and interactive Swagger/ReDoc documentation
  • Runs via Docker Compose with Nginx, PostgreSQL, and a Django-Q2 task queue

Caveats

  • The ML features are explicitly memory-intensive; 8 GB+ RAM and an SSD are strongly recommended
  • Mobile support is currently limited to an Android client built with React Native
  • The README lists ML capabilities like semantic search and image captioning, but offers no detail on model accuracy or indexing speed

Verdict

Self-hosting enthusiasts with a spare server and a large photo library will find LibrePhotos a capable alternative to cloud lock-in. If your hardware is below the 4 GB minimum or you need iOS support, this isn’t your tool yet.

Frequently asked

What is LibrePhotos/librephotos?
LibrePhotos lets you hoard photos on your own server and find that blurry shot from "Thursday in Berlin" without feeding the cloud.
Is librephotos open source?
Yes — LibrePhotos/librephotos is open source, released under the MIT license.
What language is librephotos written in?
LibrePhotos/librephotos is primarily written in Python.
How popular is librephotos?
LibrePhotos/librephotos has 8k stars on GitHub.
Where can I find librephotos?
LibrePhotos/librephotos is on GitHub at https://github.com/LibrePhotos/librephotos.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.