How tanushree2511/cove works
Cove is a local-first photo and video manager with separate photo and video backends. The main photo workflow is import or discover photos, run background face/CLIP indexing and clustering, persist vectors and people, then browse or search from the React app. Video indexing and search are a separate API-backed pipeline; the README says the React Videos link opens a separate Streamlit screen. Some service wiring is documented rather than visible in the excerpts, so those links cite the README.
Main entry points: api.py Video API · server.py Photo API · GalleryView.jsx Photo views · production_pipeline.py Photo indexing
Components 26
Photo interface
- React app
frontend/src/App.jsx - App state
frontend/src/store/useAppStore.js - Photo views
frontend/src/components/features/GalleryView.jsx - Photo card
frontend/src/components/features/PhotoCard.jsx - Search view
frontend/src/components/features/SearchView.jsx - Photo API client
frontend/src/lib/coveApi.js
Photo services
- Photo API
cove/api/server.py - Photo library
cove/api/server.py - Photo indexing
cove/pipeline/production_pipeline.py - People management
cove/engines/person_manager.py
Photo analysis
- Face analysis
cove/engines/ai_engine.py - Face clustering
cove/engines/cluster_engine.py - CLIP search
cove/engines/search_engine.py - Photo vectors
cove/engines/vector_storage.py - Hardware profile
cove/config/runtime.py
Video services
- Video API
videoModules/api.py - Video processing
videoModules/core/video_processor.py - Video face analysis
videoModules/core/face_processor.py - Video embeddings
videoModules/core/embedder.py - Video labels
videoModules/core/classifier.py - Label taxonomy
videoModules/core/label_taxonomy.py - Video transcoding
videoModules/core/transcode.py - Video database
videoModules/core/database.py - Video vectors
videoModules/core/vector_store.py
Other components
- Library user
- Video screen
Connections 28
- Library user → React app: uses
README.md - React app → Photo views: presents
frontend/src/App.jsx - Photo views → App state: reads state
- Photo views → Photo card: renders
- Search view → Photo card: renders
frontend/src/components/features/SearchView.jsx - Photo views → Photo API client: requests library data
- Search view → Photo API client: requests search
- Photo API client → Photo API: calls
- Photo API → Photo library: stores uploads
cove/api/server.py - Photo API → Photo indexing: starts indexing
README.md - Photo indexing → Face analysis: analyzes faces
cove/pipeline/production_pipeline.py - Photo indexing → Photo vectors: saves embeddings
cove/pipeline/production_pipeline.py - Photo API → CLIP search: encodes queries
cove/api/server.py - Photo API → Photo vectors: searches vectors
cove/api/server.py - Photo API → People management: manages people
cove/api/server.py - Photo API → Face clustering: clusters faces
cove/api/server.py - Hardware profile → CLIP search: configures runtime
cove/engines/search_engine.py - Hardware profile → Face analysis: tunes runtime
cove/engines/ai_engine.py - Library user → Video screen: opens Videos
README.md - Video screen → Video API: uses video service
README.md - Video API → Video transcoding: prepares uploads
videoModules/api.py - Video API → Video processing: queues processing
videoModules/api.py - Video API → Video database: registers videos
videoModules/api.py - Video API → Video face analysis: uses face analysis
videoModules/api.py - Video API → Video embeddings: uses embeddings
videoModules/api.py - Video API → Video labels: uses classification
videoModules/api.py - Video labels → Label taxonomy: uses labels
videoModules/core/classifier.py - Video API → Video vectors: uses vector search
videoModules/api.py