How the-vibe-company/quivr works
Quivr V2 is a content-ingestion, search, and monitoring engine, with a browser demo and plugin-based extension model. A client submits content through the API; the platform durably records it, asynchronously processes it into searchable projections, then serves rehydrated search results and ongoing alert matches. The graph includes the documented corpus, connector, subscription, and administration branches. The README supplies the main runtime relationships; unsampled subsystems are represented by their existing directories, and uncertain implementation-level links are omitted.
Main entry points: httpapi HTTP API · ingestion.go Temporal workers · retrieval Search and retrieval · engine.go Subscriptions and matches
Components 24
Clients and API
- Browser demo
quivr-search/src/App.tsx - Feed and search UI
quivr-search/src/components/feed/FeedPage.tsx - Alert UI
quivr-search/src/components/alerts/AlertsView.tsx - Connector UI
quivr-search/src/components/connectors/SourceList.tsx - HTTP API
internal/transport/httpapi - Corpus controls
internal/corpus
Ingestion and processing
- Connector services
internal/connectors - Upload handling
internal/uploads - Plugin HTTP adapter
internal/adapters/pluginhttp/ingestion.go - Content processing
internal/processing - Temporal workers
internal/orchestration/temporal/ingestion.go - Core ingest plugin
plugins/core-ingest/main.go
Search and storage
- PostgreSQL catalog
internal/adapters/postgres - Canonical object store
internal/adapters/s3 - Search projection
internal/adapters/weaviate - Search and retrieval
internal/retrieval - Online commands
internal/online
Monitoring and alerts
- Subscriptions and matches
internal/monitoring/engine.go - Keyword alert plugin
plugins/alerts/alerts/rule.py - Webhook delivery
internal/monitoring/webhook.go
Plugins and operations
- Plugin runtime
internal/plugins/runner/runner.go - Plugin SDK
sdks/python/src/quivr_plugin/server.py - Admin and operations
internal/operations/operations.go
Other components
- API client
Connections 26
- API client → HTTP API: submits content
- Browser demo → HTTP API: uses same API
- Feed and search UI → HTTP API: searches content
- Alert UI → HTTP API: manages alerts
- Connector UI → HTTP API: manages sources
- HTTP API → PostgreSQL catalog: commits receipts
- HTTP API → Temporal workers: dispatches work
- HTTP API → Corpus controls: applies scopes
- HTTP API → Connector services: routes connector calls
- HTTP API → Upload handling: handles uploads
- Temporal workers → Content processing: runs processing
internal/orchestration/temporal/ingestion.go - Content processing → Plugin HTTP adapter: invokes ingestion
internal/adapters/pluginhttp/ingestion.go - Plugin HTTP adapter → Core ingest plugin: calls plugin
internal/adapters/pluginhttp/ingestion.go - Temporal workers → Canonical object store: stores artifacts
- Temporal workers → Search projection: projects segments
- Temporal workers → PostgreSQL catalog: updates catalog
- HTTP API → Search and retrieval: serves search
- Search and retrieval → Search projection: queries projection
- Search and retrieval → Canonical object store: rehydrates hits
- Search and retrieval → PostgreSQL catalog: rechecks access
- Online commands → HTTP API: uses public API
- Temporal workers → Subscriptions and matches: processes matching
- Subscriptions and matches → Keyword alert plugin: evaluates pinned rules
- Subscriptions and matches → Webhook delivery: creates deliveries
- Plugin runtime → Plugin SDK: serves plugin protocol
- HTTP API → Admin and operations: exposes controls