quivr

# Quivr

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/The-Vibe-Company/quivr)

**An open-source engine for content that keeps arriving: store it, search it, and get
alerted when something new matches a topic you follow.**

You send Quivr documents (news articles, emails, posts, PDFs), or let it collect them
from RSS feeds, Microsoft 365 mailboxes and X lists. Quivr keeps every version, makes
each document searchable within seconds, and checks it against your saved alerts. Your
application talks to Quivr over an HTTP API; Quivr has no user interface of its own.

Quivr is developed by [The Vibe Company](https://www.thevibecompany.co), the AI agency
created by the Quivr team.

> **Status: Quivr 2.** From 2.0.0 on, the HTTP API (`/v0`) stays compatible across
> 2.x releases and upgrades keep your data in place; see
> [Versions and compatibility](https://docs.quivr.thevibecompany.co/reference/compatibility)
> and [Known limits](https://docs.quivr.thevibecompany.co/reference/known-limits).

## What you can do with it

- **Collect content** you send one by one or in batches, or that Quivr pulls from
  sources on a schedule. Files such as PDFs are read by plugins.
- **Search** by keywords, by meaning, or both. Every result points to the exact passage,
  document and version it comes from, so you can always cite it.
- **Follow a topic.** Save an alert such as `"harbour strike" AND (ferry OR port)`, or a
  plain-language description, and Quivr records every new document that matches, with
  the reason. Your application reads the matches or receives them as signed webhooks.
- **Keep history.** A correction becomes a new version; the old one stays readable. A
  withdrawn document leaves search at once, and alerts that caught it are told.
- **Plug in your own logic.** File formats, sources, embedding models, ranking and alert
  rules are plugins: small HTTP services you can replace, in any language.
- **Let AI agents use it.** `quivr mcp` lets an agent search Quivr and quote what it
  finds, with the source of every passage.

## How it works

```mermaid
flowchart LR
    sources[Sources and<br/>your application] -->|documents| api[Quivr API]
    api --> store[(PostgreSQL + object storage<br/>every version, kept safely)]
    store --> worker[Quivr worker]
    worker <-->|read, cut, embed,<br/>rank, judge alerts| plugins[Plugins]
    worker --> index[(Search index)]
    app[Your application] <-->|search, alerts, changes| api
```

Quivr confirms a document only once it is stored, then processes it in the background:
an outage delays processing but never loses what was confirmed. The search index can
always be rebuilt from storage. [How Quivr works](https://docs.quivr.thevibecompany.co/how-quivr-works)
explains the parts and the guarantees.

## Try it

You need Linux on x86_64 or a Mac with Apple Silicon, Docker with Compose v2, the Go
version in [`go.mod`](go.m