Product
Barrel is one database made of separate libraries. Use the barrel library for documents, files and vectors in one place, add the server for REST and MCP, or take one library on its own. Each page below says what a library does, when to use it, what it builds on and how to install it.
Start with what it does when you know the problem you want to solve: each capability page explains what it does for you and how to use it. Go to the libraries behind it when you already know which part you need and want its version, its status and its install line.
What it does
- ReplicationActive-active: every copy takes writes and convergesUse it when sites, devices or browsers must keep taking writes while apart, then agree again without losing an edit.
- SearchVector, keyword, hybrid and regex, in one query languageUse it when agents or people look things up by meaning, by keyword, or by exact text and patterns.
- TimelineBranch a database, merge it back, recover a past stateUse it when an agent should work on a copy you review before merging, or when you need the data as it was earlier.
- Agent layerSpaces, capability tokens, sessions, handoffs, MCPUse it when several agents share one server and each must reach only the data it was given.
- SecurityEncryption at rest, tokens, signed requests, mTLSUse it when data on disk must stay unreadable without its key, or when the server is reachable from other machines.
- DeploymentsEmbedded, server or browser, and how to chooseRead it first if you have not chosen where Barrel runs: inside an Erlang app, as a server, or in a browser.
The libraries behind it
Works todayOptional, needs setup
The database
-
barrel1.14.0 Records: document, files and vector under one id{barrel, "~> 1.14"}
Data
-
barrel_docdb3.1.0 Documents, versions, queries, replication{barrel_docdb, "~> 3.1"} -
barrel_vectordb2.5.4 Vector index, BM25, hybrid search{barrel_vectordb, "~> 2.5"} -
barrel_ngram0.11.5 Substring and regex search{barrel_ngram, "~> 0.11"}
Models
-
barrel_embed2.6.1 Embedding providers, local or cloud{barrel_embed, "~> 2.6"} -
barrel_rerank1.0.3 Rerank search results{barrel_rerank, "~> 1.0"}
Agents
-
barrel_spaces2.0.0 Spaces, tokens, sessions, handoffs{barrel_spaces, "~> 2.0"}
Access
-
barrel_server1.15.1 REST and MCP over HTTP{barrel_server, "~> 1.15"} -
barrel-lite0.1.0 A copy in the browser, syncedBuild from the repository
Storage and security
-
barrel_crypto1.0.0 Encryption keys and ciphers{barrel_crypto, "~> 1.0"} -
barrel_att_s30.2.2 Attachments in S3-compatible storage{barrel_att_s3, "~> 0.1"} -
barrel_faiss1.0.1 FAISS index backend{barrel_faiss, "~> 1.0"}
How the pieces fitLibraries referenceStatus of every feature