How joeydd032995-pixel/gather works
Gather is a local-first personal knowledge engine, operated through a Tauri desktop app and loopback APIs. Users import conversations, files, projects, and photos; ingestion normalizes and deduplicates them, background workers extract timestamped, provenance-linked units, and the system organizes and surfaces knowledge for search, graph browsing, and review. The graph preserves the README’s major capabilities. Some worker and route internals were not sampled, so those documented relationships cite the README rather than implying direct calls between unsampled modules.
Main entry points: db.rs PostgreSQL store · extract/mod.rs Atomic units · ingest.rs Ingestion · routes/mod.rs REST routes
Components 20
Desktop app
- Desktop interface
apps/desktop/src/App.tsx - Desktop API client
apps/desktop/src/api.ts - Review tray
apps/desktop/src/ReviewTray.tsx
API surfaces
- REST routes
daemon/src/routes/mod.rs - gRPC services
daemon/src/grpc/pipeline.rs
Knowledge pipeline
- Ingestion
daemon/src/routes/ingest.rs - Format adapters
daemon/src/adapters/mod.rs - Extraction worker
daemon/src/extract/mod.rs - Atomic units
daemon/src/extract/mod.rs - Library and search
daemon/src/library.rs - Knowledge graph
daemon/src/routes/query.rs - Project organization
daemon/src/projects/mod.rs
Organization and safety
- Topic clustering
daemon/src/cluster/worker.rs - Entity resolution
daemon/src/entities/merge.rs - Contradiction scanner
daemon/src/safety/contradiction.rs - Semantic safety
daemon/src/safety/service.rs - Photo processing
daemon/src/photo/worker.rs
Persistence
- PostgreSQL store
daemon/src/db.rs
Other components
- User
- Optional Ollama
Connections 25
- User → Desktop interface: uses
- Desktop interface → Desktop API client: requests data
apps/desktop/src/App.tsx - Desktop API client → REST routes: calls REST
- REST routes → Ingestion: routes uploads
daemon/src/routes/mod.rs - gRPC services → Ingestion: delegates ingestion
- Ingestion → Format adapters: parses exports
daemon/src/routes/ingest.rs - Ingestion → PostgreSQL store: stores artifacts
daemon/src/routes/ingest.rs - PostgreSQL store → Extraction worker: provides pending content
daemon/src/extract/mod.rs - Extraction worker → Atomic units: extracts units
daemon/src/extract/mod.rs - Extraction worker → Optional Ollama: optionally extracts
- Atomic units → PostgreSQL store: persists provenance
- REST routes → Library and search: serves search
- Library and search → PostgreSQL store: reads artifacts
- Atomic units → Knowledge graph: links entities
- Atomic units → Contradiction scanner: scans conflicts
- Atomic units → Topic clustering: groups topics
- Topic clustering → Entity resolution: resolves duplicates
- User → Review tray: corrects decisions
- Review tray → Desktop API client: submits actions
apps/desktop/src/ReviewTray.tsx - gRPC services → Review tray: serves review actions
- Contradiction scanner → Semantic safety: records decisions
- Photo processing → PostgreSQL store: reads and updates photos
daemon/src/photo/worker.rs - Project organization → PostgreSQL store: stores project data
- User → Project organization: imports folders
- User → Photo processing: imports photos