Repolode
Submit
LibrePhotos

LibrePhotos/librephotos

A self-hosted photo management service with face recognition, object tagging, and semantic search, built on Django and React.

Open-source alternative to:Google PhotosiCloud Photos

View on GitHubWebsite
Stars
8,112
Forks
413
Open issues
48
Last commit
14 hours ago

What is it?

LibrePhotos is a self-hosted photo library that indexes your existing folders and uploads, then organizes them by day, place, people and events. It handles common formats including RAW, HEIC and JPEG XL, along with videos and live photos.

The service runs machine learning pipelines locally for face detection and clustering, so you can name a person once and have the rest suggested. It also generates tags and captions for each photo, supports semantic queries such as "dog on a beach", and detects duplicates. Places come from reverse geocoding and appear on a map.

The backend is Django 5 with PostgreSQL and a React 19 web client, with an Expo mobile app for Android and iOS. It deploys as a single container, through Docker Compose, Kubernetes manifests, or as a Windows standalone build. Multiple users, shared albums, public links and OpenID Connect single sign-on are included.

Key features

  • 01Imports RAW, HEIC, JPEG XL, video and live photos from folders and uploads.
  • 02Groups photos into timelines by day and place, with auto-generated event albums.
  • 03Recognizes faces and clusters them so a named person is suggested across the library.
  • 04Supports semantic search and metadata search, with tags and captions for each photo.
  • 05Detects duplicates and keeps RAW+JPEG pairs and burst stacks together.
  • 06Offers multi-user accounts, shared albums, public links and OpenID Connect login.

Use cases

  • Replacing a cloud photo service with a library that stays on your own server.
  • Organizing a large family archive by people, places and events.
  • Searching a personal photo collection by content, such as objects or scenes.
  • Running a home photo server on a NAS or Unraid box with Docker.

Quick start

  1. 1

    Pick a deployment method from the installation list

  2. 2

    Follow the single container guide in the documentation

  3. 3

    After starting, open the web app and API docs at localhost:3000

Things to know

  • Machine learning features are memory-intensive, and 8 GB+ RAM is strongly recommended.
  • It is a self-hosted service, so you must run and maintain your own server.

In collections

Self-hosted apps

Topics

#photo-management#self-hosted#face-recognition#machine-learning#semantic-search#django#react#docker#exif#hacktoberfest

FAQ

What is librephotos?
A self-hosted photo management service with face recognition, object tagging, and semantic search, built on Django and React. LibrePhotos is a self-hosted photo library that indexes your existing folders and uploads, then organizes them by day, place, people and events. It handles common formats including RAW, HEIC and JPEG XL, along with videos and live photos.
Is librephotos free to use? What license does it have?
librephotos is open source under the MIT license. Check the license terms before using it in commercial products.
Is librephotos still maintained?
Actively maintained. The last commit to librephotos was on Oct 23, 2026.
What can I use librephotos for?
Replacing a cloud photo service with a library that stays on your own server. Organizing a large family archive by people, places and events. Searching a personal photo collection by content, such as objects or scenes. Running a home photo server on a NAS or Unraid box with Docker.
How do I install librephotos?
Pick a deployment method from the installation list Follow the single container guide in the documentation After starting, open the web app and API docs at localhost:3000
Where can I get librephotos?
The source code and installation instructions are on GitHub: https://github.com/LibrePhotos/librephotos

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects