# the-vibe-company/quivr architecture

> Architecture diagram of the GitHub repository the-vibe-company/quivr, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/the-vibe-company/quivr
- Repository: https://github.com/the-vibe-company/quivr

## Overview

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: [`internal/transport/httpapi`](https://github.com/the-vibe-company/quivr/tree/main/internal/transport/httpapi) (HTTP API), [`internal/orchestration/temporal/ingestion.go`](https://github.com/the-vibe-company/quivr/blob/main/internal/orchestration/temporal/ingestion.go) (Temporal workers), [`internal/retrieval`](https://github.com/the-vibe-company/quivr/tree/main/internal/retrieval) (Search and retrieval), [`internal/monitoring/engine.go`](https://github.com/the-vibe-company/quivr/blob/main/internal/monitoring/engine.go) (Subscriptions and matches)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Clients and API"]
  node_web["Browser demo<br/>[App.tsx]"]
  node_feed["Feed and search UI<br/>[FeedPage.tsx]"]
  node_alertui["Alert UI<br/>[AlertsView.tsx]"]
  node_connectui["Connector UI<br/>[SourceList.tsx]"]
  node_api["HTTP API"]
  node_corpus["Corpus controls"]
end

subgraph group_ingest["Ingestion and processing"]
  node_connectors["Connector services"]
  node_uploads["Upload handling"]
  node_pluginhttp["Plugin HTTP adapter<br/>[ingestion.go]"]
  node_processing["Content processing"]
  node_temporal["Temporal workers<br/>[ingestion.go]"]
  node_coreingest["Core ingest plugin<br/>[main.go]"]
end

subgraph group_search["Search and storage"]
  node_pg[("PostgreSQL catalog")]
  node_s3[("Canonical object store")]
  node_weaviate[("Search projection")]
  node_retrieval["Search and retrieval"]
  node_online["Online commands"]
end

subgraph group_monitor["Monitoring and alerts"]
  node_subscriptions["Subscriptions and matches<br/>[engine.go]"]
  node_alerts["Keyword alert plugin<br/>[rule.py]"]
  node_delivery["Webhook delivery<br/>[webhook.go]"]
end

subgraph group_ext["Plugins and operations"]
  node_pluginhost["Plugin runtime<br/>[runner.go]"]
  node_pluginapi["Plugin SDK<br/>[server.py]"]
  node_admin["Admin and operations<br/>[operations.go]"]
end

node_client(("API client"))

node_client -->|"submits content"| node_api
node_web -->|"uses same API"| node_api
node_feed -.->|"searches content"| node_api
node_alertui -.->|"manages alerts"| node_api
node_connectui -.->|"manages sources"| node_api
node_api -->|"commits receipts"| node_pg
node_api -->|"dispatches work"| node_temporal
node_api -->|"applies scopes"| node_corpus
node_api -.->|"routes connector calls"| node_connectors
node_api -.->|"handles uploads"| node_uploads
node_temporal -->|"runs processing"| node_processing
node_processing -->|"invokes ingestion"| node_pluginhttp
node_pluginhttp -->|"calls plugin"| node_coreingest
node_temporal -->|"stores artifacts"| node_s3
node_temporal -->|"projects segments"| node_weaviate
node_temporal -.->|"updates catalog"| node_pg
node_api -.->|"serves search"| node_retrieval
node_retrieval -->|"queries projection"| node_weaviate
node_retrieval -->|"rehydrates hits"| node_s3
node_retrieval -->|"rechecks access"| node_pg
node_online -->|"uses public API"| node_api
node_temporal -.->|"processes matching"| node_subscriptions
node_subscriptions -->|"evaluates pinned rules"| node_alerts
node_subscriptions -->|"creates deliveries"| node_delivery
node_pluginhost -.->|"serves plugin protocol"| node_pluginapi
node_api -.->|"exposes controls"| node_admin

click node_web "https://github.com/the-vibe-company/quivr/blob/main/quivr-search/src/App.tsx"
click node_feed "https://github.com/the-vibe-company/quivr/blob/main/quivr-search/src/components/feed/FeedPage.tsx"
click node_alertui "https://github.com/the-vibe-company/quivr/blob/main/quivr-search/src/components/alerts/AlertsView.tsx"
click node_connectui "https://github.com/the-vibe-company/quivr/blob/main/quivr-search/src/components/connectors/SourceList.tsx"
click node_api "https://github.com/the-vibe-company/quivr/tree/main/internal/transport/httpapi"
click node_corpus "https://github.com/the-vibe-company/quivr/tree/main/internal/corpus"
click node_connectors "https://github.com/the-vibe-company/quivr/tree/main/internal/connectors"
click node_uploads "https://github.com/the-vibe-company/quivr/tree/main/internal/uploads"
click node_pluginhttp "https://github.com/the-vibe-company/quivr/blob/main/internal/adapters/pluginhttp/ingestion.go"
click node_processing "https://github.com/the-vibe-company/quivr/tree/main/internal/processing"
click node_temporal "https://github.com/the-vibe-company/quivr/blob/main/internal/orchestration/temporal/ingestion.go"
click node_coreingest "https://github.com/the-vibe-company/quivr/blob/main/plugins/core-ingest/main.go"
click node_pg "https://github.com/the-vibe-company/quivr/tree/main/internal/adapters/postgres"
click node_s3 "https://github.com/the-vibe-company/quivr/tree/main/internal/adapters/s3"
click node_weaviate "https://github.com/the-vibe-company/quivr/tree/main/internal/adapters/weaviate"
click node_retrieval "https://github.com/the-vibe-company/quivr/tree/main/internal/retrieval"
click node_online "https://github.com/the-vibe-company/quivr/tree/main/internal/online"
click node_subscriptions "https://github.com/the-vibe-company/quivr/blob/main/internal/monitoring/engine.go"
click node_alerts "https://github.com/the-vibe-company/quivr/blob/main/plugins/alerts/alerts/rule.py"
click node_delivery "https://github.com/the-vibe-company/quivr/blob/main/internal/monitoring/webhook.go"
click node_pluginhost "https://github.com/the-vibe-company/quivr/blob/main/internal/plugins/runner/runner.go"
click node_pluginapi "https://github.com/the-vibe-company/quivr/blob/main/sdks/python/src/quivr_plugin/server.py"
click node_admin "https://github.com/the-vibe-company/quivr/blob/main/internal/operations/operations.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_feed,node_alertui,node_connectui,node_api,node_corpus,node_client toneBlue
class node_connectors,node_uploads,node_pluginhttp,node_processing,node_temporal,node_coreingest toneAmber
class node_pg,node_s3,node_weaviate,node_retrieval,node_online toneMint
class node_subscriptions,node_alerts,node_delivery toneRose
class node_pluginhost,node_pluginapi,node_admin toneIndigo
```

## Components

### Clients and API

- [Browser demo](https://github.com/the-vibe-company/quivr/blob/main/quivr-search/src/App.tsx): `quivr-search/src/App.tsx`
- [Feed and search UI](https://github.com/the-vibe-company/quivr/blob/main/quivr-search/src/components/feed/FeedPage.tsx): `quivr-search/src/components/feed/FeedPage.tsx`
- [Alert UI](https://github.com/the-vibe-company/quivr/blob/main/quivr-search/src/components/alerts/AlertsView.tsx): `quivr-search/src/components/alerts/AlertsView.tsx`
- [Connector UI](https://github.com/the-vibe-company/quivr/blob/main/quivr-search/src/components/connectors/SourceList.tsx): `quivr-search/src/components/connectors/SourceList.tsx`
- [HTTP API](https://github.com/the-vibe-company/quivr/tree/main/internal/transport/httpapi): `internal/transport/httpapi`
- [Corpus controls](https://github.com/the-vibe-company/quivr/tree/main/internal/corpus): `internal/corpus`

### Ingestion and processing

- [Connector services](https://github.com/the-vibe-company/quivr/tree/main/internal/connectors): `internal/connectors`
- [Upload handling](https://github.com/the-vibe-company/quivr/tree/main/internal/uploads): `internal/uploads`
- [Plugin HTTP adapter](https://github.com/the-vibe-company/quivr/blob/main/internal/adapters/pluginhttp/ingestion.go): `internal/adapters/pluginhttp/ingestion.go`
- [Content processing](https://github.com/the-vibe-company/quivr/tree/main/internal/processing): `internal/processing`
- [Temporal workers](https://github.com/the-vibe-company/quivr/blob/main/internal/orchestration/temporal/ingestion.go): `internal/orchestration/temporal/ingestion.go`
- [Core ingest plugin](https://github.com/the-vibe-company/quivr/blob/main/plugins/core-ingest/main.go): `plugins/core-ingest/main.go`

### Search and storage

- [PostgreSQL catalog](https://github.com/the-vibe-company/quivr/tree/main/internal/adapters/postgres): `internal/adapters/postgres`
- [Canonical object store](https://github.com/the-vibe-company/quivr/tree/main/internal/adapters/s3): `internal/adapters/s3`
- [Search projection](https://github.com/the-vibe-company/quivr/tree/main/internal/adapters/weaviate): `internal/adapters/weaviate`
- [Search and retrieval](https://github.com/the-vibe-company/quivr/tree/main/internal/retrieval): `internal/retrieval`
- [Online commands](https://github.com/the-vibe-company/quivr/tree/main/internal/online): `internal/online`

### Monitoring and alerts

- [Subscriptions and matches](https://github.com/the-vibe-company/quivr/blob/main/internal/monitoring/engine.go): `internal/monitoring/engine.go`
- [Keyword alert plugin](https://github.com/the-vibe-company/quivr/blob/main/plugins/alerts/alerts/rule.py): `plugins/alerts/alerts/rule.py`
- [Webhook delivery](https://github.com/the-vibe-company/quivr/blob/main/internal/monitoring/webhook.go): `internal/monitoring/webhook.go`

### Plugins and operations

- [Plugin runtime](https://github.com/the-vibe-company/quivr/blob/main/internal/plugins/runner/runner.go): `internal/plugins/runner/runner.go`
- [Plugin SDK](https://github.com/the-vibe-company/quivr/blob/main/sdks/python/src/quivr_plugin/server.py): `sdks/python/src/quivr_plugin/server.py`
- [Admin and operations](https://github.com/the-vibe-company/quivr/blob/main/internal/operations/operations.go): `internal/operations/operations.go`

### Other components

- **API client**

## Connections

- 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 (evidence: `internal/orchestration/temporal/ingestion.go`)
- Content processing → Plugin HTTP adapter: invokes ingestion (evidence: `internal/adapters/pluginhttp/ingestion.go`)
- Plugin HTTP adapter → Core ingest plugin: calls plugin (evidence: `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
