Skip to content

Changelog

All notable changes to proton-faces are documented here. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Releases are cut by pushing a v* tag (or running the Release workflow with a version) — see Installation → Releases. The GitHub Release notes are generated from merged PRs; this file is the curated, human-written record.

Unreleased

Fixed

  • Admin schedule setter no longer silently ignores invalid values — PUT /api/admin/schedule now returns 400 with the list of rejected fields (out-of-range hour/minute/keep, non-numeric values, non-boolean enabled) instead of keeping the old values and reporting success (issue #111).
  • Scheduled backups no longer skip their minute — the backup worker now catches up with a single backup if it was down at the scheduled time, instead of racing the exact hh:mm on its 60-second tick and silently missing the slot (issue #111).

Added

  • Optional OpenTelemetry metrics — app and indexer export request, search, model-load, photo and per-job metrics over OTLP/HTTP when OTEL_EXPORTER_OTLP_ENDPOINT is set. Off by default. See Observability.
  • User-selectable person cover photo — the "main photo" shown on each People card is no longer stuck at "highest-confidence crop". A Set photo button on each card opens a face-crop grid picker; a Set as cover action is also available from the face popover in photo detail. Backed by GET /api/people/{id}/faces and POST /api/people/{id}/cover.
  • MkDocs documentation site with dark-slate + amber Material theme, deployed to GitHub Pages (docs site).
  • DEMO_MODE (DEMO_MODE=1) — runs the full app without a Proton account. Built-in fixture of 82 CC0/Unsplash photos (32 face portraits + 50 picsum scenes), auto-created demo admin user, GPS-injected for the places demo.
  • docker compose --profile demo brings up only indexer-demo + app-demo; the proton-bridge container is skipped.
  • scripts/fetch-demo-assets.py — fetches the demo fixture (idempotent, re-runnable).
  • scripts/capture_screenshots.py — Playwright-driven capture of every UI view (PNG screenshots + MP4 screencasts). Used to generate the docs assets.

Changed

  • New public site. GitHub Pages now serves a hand-built product page at the root (website/), an 80-second canvas film at /video/ (English and French, no video file), and this documentation under /docs/ with a matching "viewfinder" skin. Old documentation URLs redirect to /docs/. Build locally with scripts/build-site.sh.
  • compose.yml now includes the demo profile services.
  • Demo profile services (indexer-demo, app-demo) now carry the same container hardening as prod (cap_drop: ALL, no-new-privileges, mem_limit, pids_limit, CPU caps) — demo is the profile most likely to be exposed publicly (issue #110).
  • .env.example documents DEMO_MODE and DEMO_ADMIN_PASSWORD.

0.9.0 — Multi-user auth (PR-9)

Added

  • Local multi-user accounts (username + bcrypt password).
  • Roles: read, write, admin.
  • Bearer-token authentication with separate access (8 h) and refresh (30 d) tokens.
  • Per-user favorites (user_favorites table).
  • Admin area (gear-icon modal): overview, health checks, backups, schedule, users.

0.8.0 — Three-container split (issue #4)

Changed

  • Recognition pipeline moved to its own indexer container.
  • app container serves the FastAPI API + web UI only by default.
  • Single-process layout still available via RUN_INDEXER=1.

0.7.0 — HEIC + video support

Added

  • Local thumbnail generation for HEIC/HEIF photos (no Proton preview).
  • Video poster extraction via ffmpeg; ffprobe-based duration.

0.6.0 — Face tagging propagation

Added

  • Naming one face auto-tags every unassigned face with cosine similarity above FACE_SIM_THRESHOLD.
  • Suggested merges (pairwise cluster similarity ≥ 0.40).

0.5.0 — Places

Added

  • GPS reverse-geocoding via reverse_geocoder.
  • Leaflet world map with clustered city markers.
  • Per-person map view.

Added

  • Zero-shot CLIP text search.
  • Face search by example (multipart upload).
  • Free-text search debounced 250 ms.

0.3.0 — People + clustering

Added

  • InsightFace (RetinaFace + ArcFace) for detection + embeddings.
  • HDBSCAN clustering, incremental.
  • People grid with face-crop covers.
  • Rename / merge / unassign.

0.2.0 — Indexing pipeline

Added

  • Proton bridge (Bun + Proton SDK).
  • Thumbnail downloader.
  • Recognition workers.
  • SQLite index + numpy vector store.

0.1.0 — Initial release

Added

  • FastAPI app + vanilla-JS web UI.
  • Three-tab navigation (Photos, Favorites, Archive).
  • Date rail, "On this day" strip.
  • Stars, archive, hide.