Repo brief: LibrePhotos/librephotos

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T18:33:10.107Z · commit 2591afa20de3

Verdict

Healthy — Healthy across all four use cases

• Last commit 3d ago
• 6 active contributors
• Distributed ownership (top contributor 48% of recent commits)
• MIT licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

LibrePhotos is a self-hosted, open-source photo management service built on Django 5 with PostgreSQL, combining automatic face recognition, object detection, semantic image search, and reverse geocoding powered by machine learning models like insightface and sentence-transformers. It handles RAW photos, videos, and supports multiuser access with automatic event-based album generation—solving the need for privacy-respecting, on-premise photo organization without vendor lock-in. Monorepo with five consolidated services: apps/backend/ (Django 5 REST API + ML pipelines via Django-Q2 task queue), apps/frontend/ (React 18 + Vite), apps/mobile/ (React Native Android), apps/docs/…

Start here

Open these first:

• apps/backend/api/apps.py — Django app configuration entry point that initializes the backend API and registers all core models and services.
• apps/backend/api/models.py — Core data models (Photo, Person, Album, Face) defining the photo library schema and relationships; foundational to all…
• apps/backend/api/views.py — REST API endpoints using Django REST Framework that handle photo management, face recognition, and search operations.
• apps/backend/api/face_recognition.py — Machine-learning pipeline for face detection and recognition using InsightFace, a primary feature of the service.
• apps/backend/api/directory_watcher/scan_jobs.py — Background job orchestration for scanning photo directories and triggering ML processing pipelines.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

1. Clone: git clone https://github.com/LibrePhotos/librephotos.git && cd librephotos
2. Backend setup (inferred from requirements): cd apps/backend && pip install -r requirements.txt (verify exact manifest location in repo)
3. Frontend setup: cd apps/frontend && npm install (or yarn install if package-lock.json present)
4. Database: PostgreSQL must be running (requirements reference psycopg==3.3.4)
5. Task queue: Django-Q2 requires Redis or in-memory setup (verify settings.py)
6. Run backend: python manage.py runserver
7. Run frontend: npm run dev (assuming Vite dev server) See apps/backend/README.md and apps/frontend/ manifest for confirmed commands before executing.

Daily commands:

Backend: cd apps/backend && python manage.py runserver 8000 (requires .env with DATABASE_URL pointing to PostgreSQL, SECRET_KEY, and Django-Q2 Redis/cache config—verify settings.py). Frontend: `cd apps/fro…

…shortened for this brief.

Key cautions & unknowns

• Python version splits: Scikit-learn and timezonefinder have Python 3.10 vs 3.11+ pins in requirements due to CUDA/GPU build constraints—bumping versions without checking python_version markers breaks GPU image…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.