Modules§
- classify
- Classifications table: one row per unique content hash (photo/screenshot/
document/meme/unknown), keyed to embeddings.hash. Zero-shot classification
reuses embeddings
videre embedalready computed. See docs/superpowers/specs/2026-07-29-screenshot-document-classification-design.md. - db
- embeddings
- Embeddings table: one row per unique content hash, keyed to file_hashes.hash.
- embeddings_
db - Per-model embedding databases: one SQLite file per (library, model) pair,
attached to the main connection as
emb. - face_
cluster - face_db
- geocode
- Forward geocoding: place name (e.g. “Berlin, Germany”) -> (lat, lon), via the free public Nominatim (OpenStreetMap) API, with a local cache so a repeated query never repeats the network call. See docs/superpowers/specs/2026-08-01-location-clustering-design.md.
- heic
- home
- io_
timeout - library_
stats - Aggregate library statistics for dashboard-style callers.
Plain queries over an open
rusqlite::Connection, shared source of truth forvidere report’s stats tile,videre stats, and any other embedder. See docs/superpowers/specs/2026-07-31-dashboard-stats-backend-design.md (Pass A) for what is and isn’t in scope. - location
- location_
cluster - GPS coordinate clustering: groups nearby
(lat, lon)points by haversine distance into named location clusters, persisted tolocation_clusters+file_hashes.location_cluster_id. See docs/superpowers/specs/2026-08-01-location-clustering-design.md. - mime_
probe - Identify a file’s real type from its leading bytes.
- person_
search - pipeline_
runs - Per-command pipeline run history and liveness, surfaced by
videre statsand other dashboard-style callers. See docs/superpowers/specs/2026-07-31-dashboard-stats-pass-b-design.md for the full design, and in particular whytrack()below does not rely on Drop/RAII for the success/failure bookkeeping, only the lock’s release does, and even that is backstopped by the OS releasingflockon any process death. - progress
- semaphore
- thumb_
cache - vectors
- f32 <-> f16 BLOB conversion and L2 normalization for stored embeddings. Storage format: little-endian f16, 2 bytes per dimension.
- video_
probe - Detect whether a QuickTime/MP4 container has a video track, without decoding anything.