TiloBox
Back to directory
LibrePhotos project preview
MediaAlternative to Google Photos

LibrePhotos

Self-hosted, AI-driven photo management gallery and open-source Google Photos alternative.

View on GitHub Visit website
LicenseMIT
GitHub stars8.0k
Last commit1 weeks ago
Tags6 topics
AiFacial RecognitionGallerySelf HostedPhotosPython
Overview

Why consider LibrePhotos?

LibrePhotos is an open-source photo server featuring automatic facial recognition, object detection, and location clustering. It provides complete ownership of your personal photo memories.

Guided learning

Learn LibrePhotos by building

Practical setup notes, real use cases, and copy-ready examples in one focused guide.

3 min read 10 sections
In this guide10 sections

What is LibrePhotos?

LibrePhotos is an open-source, self-hosted photo management server and gallery application built with Django, React, and Python. It serves as a direct private alternative to commercial photo storage platforms like Google Photos and Apple iCloud.

LibrePhotos uses offline machine learning models to detect faces, recognize objects and scenes, extract semantic visual labels, generate interactive location maps, and automatically compile album timelines without transmitting any user data over external networks.

Who Is It For?

  • Privacy Advocates: Managing family photo archives on personal servers with on-device AI recognition and zero telemetry.
  • Photographers: Scanning multi-terabyte image collections with non-destructive index modes and RAW file rendering.
  • Homelabbers: Running a comprehensive self-hosted photo gallery accessible from web browsers and mobile clients.

Key Features

  • Facial recognition engine with automatic face clustering, identity tagging, and unknown face suggestions.
  • Semantic object and scene detection (e.g. food, mountains, cats, cars) powered by machine learning.
  • Interactive geographic map view plotting photos using EXIF GPS coordinates.
  • Timeline calendar view organizing media into years, months, and days.
  • Support for multiple image formats including JPEG, PNG, HEIC, WebP, and RAW camera files.

Deploying LibrePhotos with Docker Compose

yaml
1version: '3.7'
2
3services:
4 backend:
5 image: reallibrephotos/librephotos:latest
6 container_name: librephotos_backend
7 restart: unless-stopped
8 volumes:
9 - /media/photos:/data
10 - ./protected_media:/protected_media
11 environment:
12 - DB_BACKEND=postgresql
13 - DB_NAME=librephotos
14 - DB_USER=librephotos
15 - DB_PASS=secure_libre_db_password
16 - DB_HOST=db
17 - DB_PORT=5432
18 - ADMIN_EMAIL=admin@example.com
19 - ADMIN_USERNAME=admin
20 - ADMIN_PASSWORD=secure_admin_password
21 depends_on:
22 - db
23
24 db:
25 image: postgres:15-alpine
26 container_name: librephotos_db
27 restart: unless-stopped
28 volumes:
29 - ./pgdata:/var/lib/postgresql/data
30 environment:
31 - POSTGRES_DB=librephotos
32 - POSTGRES_USER=librephotos
33 - POSTGRES_PASSWORD=secure_libre_db_password
34
35 frontend:
36 image: reallibrephotos/librephotos-frontend:latest
37 container_name: librephotos_frontend
38 restart: unless-stopped
39 ports:
40 - 3000:3000
41 depends_on:
42 - backend

Start the instance:

bash
1docker compose up -d

Access http://localhost:3000 in your browser and log in with your configured admin credentials.

Practical Use Cases

1. Face Clustering and Family Timelines

A user uploads thousands of mixed family photos; LibrePhotos clusters faces into individuals, allowing one-click filtering to view all photos of a specific relative across twenty years.

2. Location-Based Vacation Exploration

A traveler opens the interactive map view and zooms into specific cities to view all photos captured during a European road trip based on embedded GPS coordinates.

3. Semantic Search Querying

A user types "snow forest sunset" in the search bar, and LibrePhotos instantly returns relevant photos using its pre-trained visual concept models.

Troubleshooting and Limitations

  • Face Recognition Hardware Load: Initial face clustering scans on large photo libraries require significant CPU computation; let background scans complete overnight.
  • HEIC Image Codecs: For Apple iPhone HEIC photo rendering, ensure the LibrePhotos container includes libheif packages (included in official Docker images).

Official Resources

Related tools

More options with a similar category or technology profile.

MyPaint logo

MyPaint

Nimble, distraction-free, and easy graphic application for digital painters.

Pencil2D logo

Pencil2D

Easy, intuitive traditional hand-drawn 2D animation software across raster and vector.

Hydrogen logo

Hydrogen

Advanced open-source drum machine and pattern-based step sequencer for audio production.

Pure Data logo

Pure Data

Open source visual programming language for multimedia, audio, and physical computing.

LibrePhotos FAQs

LibrePhotos is listed as a Media tool on TiloBox. Review the overview, features, and official documentation on this page to decide whether it solves your specific workflow.

Start with the project's GitHub repository and official website for supported installation and deployment instructions. Test the setup with representative data or a small project before rolling it out more widely.

LibrePhotos is listed under the MIT license. Read the complete license text and the project's notices before using, modifying, or distributing the software.

Production readiness depends on your requirements. Review maintenance activity, security practices, documentation, backup and upgrade procedures, and compatibility with your stack; then validate it in a non-production environment.

LibrePhotos is listed as an alternative to Google Photos. Compare the core workflow, deployment model, integrations, and licensing against your must-have requirements before switching.