Une base de données pour les agents.
Donnez à chaque agent, chaque client et chaque tâche sa propre base. Barrel garde le document, les fichiers qui y sont attachés et son vecteur sous un même identifiant. Vous y cherchez par le sens et par mots-clés, vous gardez chaque version, vous créez des branches pour faire des essais, vous la synchronisez avec d’autres nœuds et des navigateurs, et vous la partagez avec des jetons de capacité.
Vous en avez besoin quand des agents lisent et écrivent les données dont votre application dépend : articles de support, tâches, notes, code. D’habitude, chaque élément est éclaté entre une base de documents, un stockage de fichiers et un index vectoriel, et c’est votre code qui garde les trois en phase. Dans Barrel, ils forment un seul enregistrement : les fichiers et le vecteur restent liés au document auquel ils appartiennent.
Chaque copie accepte les écritures, sur un serveur, en périphérie ou dans un navigateur, et la réplication les remet d’accord sans perdre une seule modification. Intégrée en Erlang, servie en REST et en MCP. Open source, Apache 2.0.
Commencer Qu’est-ce que Barrel ?
Ajoutez-le à votre rebar.config
{deps, [{barrel, "~> 1.14"}]}. Chaque copie accepte les écritures
La réplication active-active veut dire que chaque copie d’une base accepte les écritures. Il n’y a ni leader ni copie principale à joindre d’abord : sites, nœuds en périphérie et navigateurs continuent chacun de travailler quand le réseau entre eux est coupé.
Quand ils se reconnectent, les copies échangent leurs modifications et convergent : elles finissent avec les mêmes documents et s’accordent sur la même version de chacun. Vous en avez besoin quand un site, un appareil ou un navigateur doit continuer à travailler malgré une connexion perdue, ou quand des personnes à plusieurs endroits modifient les mêmes données.
- La même réponse partout. Chaque copie choisit la même version gagnante pour chaque document.
- Aucune modification perdue. Les modifications concurrentes restent des conflits jusqu’à ce que vous les résolviez.
- Reprend après une panne. Points de reprise à chaque lot ; testé avec des arrêts brutaux et des coupures de courant.
- Documents et fichiers. Les pièces jointes voyagent avec leurs documents.
Deux sites modifient la même tâche
Coupez la liaison, modifiez des deux côtés, synchronisez. Aucune modification n’est perdue : les deux copies choisissent la même gagnante et gardent l’autre modification comme conflit jusqu’à ce que quelqu’un le résolve.
L’appel derrière votre dernière actionDémonstration dans votre navigateur, selon les règles de barrel
Ce que vous construisez avec
Huit architectures pour lesquelles Barrel est conçu. Chaque onglet part d’un problème que vous avez peut-être déjà, par exemple empêcher des agents de lire les données les uns des autres ou garder une application utilisable hors ligne, puis montre comment Barrel le traite : les pièces en jeu et le code. Choisissez celui qui ressemble le plus à ce que vous construisez ; chacun a sa page et un exemple à exécuter.
Une base par agent
Le problème
Des agents qui partagent une même base voient et écrasent le travail des autres, et vous ne pouvez pas couper l’accès d’un agent sans toucher aux autres.
Avec Barrel
Chaque agent reçoit un espace : sa propre base et un jeton qui dit ce qu’il peut lire ou écrire. Révoquez le jeton, l’agent n’a plus accès.
Planificateur accorde un jeton Espace sp_research jeton via MCP Agent de recherche
{ok, #{id := Sp}} = barrel_spaces:create_space(
#{label => <<"research">>, owner => <<"planner">>}),
{ok, Token, _} = barrel_caps:grant(Sp,
#{rights => [read, write], subject => <<"researcher">>}),
%% the agent sends Token as a bearer token to /mcp
ok = barrel_caps:revoke(Token). Lire le cas d’usage Utilise barrel_spaces, barrel_server
Écrire sur chaque nœud
Le problème
Sites, appareils et régions ont chacun besoin de leurs données en local, plus d’une copie centrale, sur des liaisons qui vont et viennent.
Avec Barrel
Intégrez Barrel sur chaque nœud et lancez une tâche de réplication continue vers le hub. Des filtres et des canaux décident de ce qui va où.
Nœud en périphérie envoi continu Hub barrel_server récupéré par les autres Autres nœuds
{ok, TaskId} = barrel_rep_tasks:start_task(#{
source => <<"inventory">>,
target => <<"http://hub.example:8080/db/inventory">>,
mode => continuous,
direction => push,
filter => #{channel => <<"mobile">>}}). Lire le cas d’usage Utilise barrel_docdb, barrel_server
Une base par client
Le problème
Des données clients mélangées dans des tables partagées imposent un filtre sur chaque requête, et supprimer un client oblige à traquer ses lignes.
Avec Barrel
Un espace par client, chiffré avec sa propre clé. Au départ du client, l’espace est supprimé et chaque jeton émis pour lui est révoqué.
Votre backend SaaS un par client Espace sp_acme sa propre clé Fournisseur de clés
Enc = #{provider => tenant_keys},
{ok, #{id := Acme}} = barrel_spaces:create_space(#{
label => <<"acme">>,
encryption => Enc}),
%% offboarding: the data and every grant go
ok = barrel_spaces:drop_space(Acme, #{encryption => Enc}). Lire le cas d’usage Utilise barrel_spaces, barrel_crypto
La mémoire des agents
Le problème
Un agent oublie d’un tour à l’autre, sauf si vous gardez la conversation, ses notes et ce qui compte, et pouvez les retrouver plus tard.
Avec Barrel
Les sessions gardent les messages et des données de travail avec une expiration glissante, les notes épinglées restent au premier plan, et le mode enregistrement rend les documents stockés cherchables par le sens.
Agent de support à chaque tour Session dans un espace expire après ttl Documents cherchables
{ok, Sid} = barrel_session:create(Space,
#{agent => <<"support">>, ttl => 3600}),
{ok, _} = barrel_session:add_message(Space, Sid,
#{role => <<"user">>, content => <<"I am locked out">>}),
{ok, _} = barrel_session:pin_context(Space, Sid,
#{content => <<"enterprise plan">>, priority => 0}),
{ok, Recent} = barrel_session:get_messages(Space, Sid,
#{limit => 20}). Lire le cas d’usage Utilise barrel_spaces, barrel
Recherche privée dans vos connaissances
Le problème
La recherche documentaire pour un modèle (RAG) suppose en général un stockage de documents, une base vectorielle et un service d’embeddings à garder en phase, et vos données quittent votre réseau.
Avec Barrel
Écrivez des documents. Barrel calcule leurs embeddings avec un modèle local, cherche par le sens et par mots-clés en même temps, et peut reclasser les meilleurs résultats. Vous transmettez ces résultats à votre modèle.
Documents embedding à l’écriture barrel, mode enregistrement recherche hybride Reclassement meilleurs résultats Votre appel au LLM
{ok, Db} = barrel:open(kb, #{embedding => #{
fields => [<<"title">>, <<"body">>],
embedder => {local, #{}}}}),
{ok, Hits} = barrel:search_hybrid(Db,
<<"customer cannot log in">>, #{k => 20}),
%% optional: barrel_rerank:rerank(Pid, Query, Texts)
%% then pass the best hits to your model Lire le cas d’usage Utilise barrel, barrel_embed, barrel_rerank
Recherche de code pour agents de développement
Le problème
Un agent de développement a autant besoin de correspondances exactes (un code d’erreur, un symbole, un motif) que de réponses par le sens.
Avec Barrel
Un index de trigrammes répond aux requêtes par sous-chaîne et par expression régulière sur les champs que vous choisissez ; la recherche hybride répond par le sens. Les deux sont des outils MCP.
Agent de développement ngram_search, search barrel_server MCP Morceaux de code index de trigrammes
ok = barrel_ngram:open(<<"src_idx">>,
#{db => <<"code">>, fields => [<<"text">>]}),
barrel_ngram:search(<<"src_idx">>, <<"ERR_CONN_TIMEOUT">>),
barrel_ngram:regex(<<"src_idx">>, <<"\\w+_timeout">>). Lire le cas d’usage Utilise barrel_ngram, barrel_server
Une branche par exécution d’agent
Le problème
Laisser un agent modifier des données en production est risqué, et copier une base pour faire des essais prend du temps.
Avec Barrel
Créez une branche en temps constant, laissez l’agent travailler sur la copie, examinez ce qui a changé, puis fusionnez ou jetez la branche. Créez une branche à un instant passé pour récupérer un état.
main Exécution de l’agent sur une branche relecture fusionner ou supprimer
{ok, Run} = barrel:branch(Db, run_42,
#{vectordb => #{db_path => "data/run_42_vec"}}),
%% the agent writes to Run, you review it
{ok, _Report} = barrel:merge(Run),
ok = barrel:delete(Run). Lire le cas d’usage Utilise barrel, barrel_docdb
Applications hors ligne d’abord
Le problème
Une application de terrain doit continuer à fonctionner sans connexion et rattraper son retard ensuite sans perdre de modifications.
Avec Barrel
barrel-lite garde une copie dans le navigateur, lit et écrit en local, et synchronise dans les deux sens quand la connexion revient.
Application web lectures et écritures locales barrel-lite (OPFS) /db/:db/_sync barrel_server
const db = await Database.open("visits", {
remote: { url: "https://hub.example:8080",
db: "visits", token },
});
await db.put({ id: "v-311", site: "Lyon 2" });
const live = db.liveSync(); // sync while online Lire le cas d’usage Utilise barrel-lite, barrel_server
Trois endroits où la faire tourner
C’est par ici que vous commencez. Barrel est la même base aux trois endroits : le même enregistrement, le même protocole de réplication, si bien que des copies placées à des endroits différents peuvent se synchroniser. Choisissez où vit la base selon le langage de votre application, selon que ses clients y accèdent par le réseau ou non, et selon qu’elle doit fonctionner hors ligne. Les agents qui l’utilisent ne changent pas, et vous pourrez ajouter les autres endroits plus tard.
Intégrée
Dans votre release Erlang/OTP. Aucun aller-retour réseau, aucun service séparé à faire tourner.
- Votre applicationagents, workers, processus OTP
appelle l’API barrel
- barrelenregistrements, recherche, branches
stocke dans
- RocksDB sur disque localdocuments, pièces jointes, vecteurs
Pour une application Erlang ou Elixir qui possède ses données. Vous ajoutez barrel en dépendance et vous l’appelez comme une bibliothèque, avec toute l’API.
Serveur
Un nœud partagé par de nombreux clients : les agents en MCP, les services en REST, les autres nœuds par le protocole de synchronisation.
- Agents et servicesclients MCP, curl, votre backend
MCP sur /mcp, REST sur /db
- barrel_serverauthentification, jetons de capacité, espaces
appelle
- barrella même base intégrée
Pour des clients écrits dans d’autres langages ou sur d’autres machines, et pour les agents d’IA qui se connectent en MCP, le protocole qu’utilisent les outils d’agents pour appeler des services extérieurs. Commencez ici si vous n’écrivez pas en Erlang.
Navigateur
Une copie locale dans une application web. Lectures et écritures continuent de fonctionner hors ligne.
- Votre application webTypeScript
lit et écrit en local
- barrel-litestocke dans le navigateur (OPFS)
se synchronise via /db/:db/_sync
- barrel_serverla copie avec laquelle il se synchronise
Pour une application web dont les utilisateurs doivent continuer à travailler sans connexion. La copie du navigateur se synchronise avec un barrel_server, qui garde la copie durable : vous en faites donc tourner un aussi.
Vous hésitez ? Choisir un déploiement compare les trois dans un seul tableau : ce que chacun apporte et ce qu’il faut savoir avant de choisir.
Essayez en deux minutes
Chaque onglet écrit l’article de support kb-142 et le relit avec une requête BQL, le langage de requête de Barrel, proche de SQL. L’onglet Erlang appelle directement la bibliothèque et ouvre la base sans stockage vectoriel : il n’a besoin d’aucun modèle d’embeddings. L’onglet REST parle avec curl à un barrel_server déjà lancé. L’onglet TypeScript écrit dans la copie du navigateur, puis la synchronise avec le serveur. Prenez l’onglet qui correspond à l’endroit où vous faites tourner Barrel, puis suivez son démarrage rapide pour l’installer.
{ok, _} = application:ensure_all_started(barrel),
{ok, Db} = barrel:open(<<"kb">>, #{vectordb => none}),
{ok, _} = barrel:put_doc(Db, #{<<"id">> => <<"kb-142">>,
<<"title">> => <<"Reset a locked account">>}),
{ok, Rows, _} = barrel:query(Db,
<<"SELECT id, title FROM kb WHERE id = 'kb-142'">>). curl -X PUT localhost:8080/db/kb
curl -X PUT localhost:8080/db/kb/doc/kb-142 \
-H 'content-type: application/json' \
-d '{"title":"Reset a locked account"}'
curl -X POST localhost:8080/db/kb/query \
-H 'content-type: text/plain' \
--data-binary "SELECT id, title FROM kb WHERE id = 'kb-142'" import { Database } from "barrel-lite";
const db = await Database.open("kb", {
remote: { url: "http://localhost:8080", db: "kb", token },
});
await db.put({ id: "kb-142", title: "Reset a locked account" });
await db.sync(); // envoie les écritures locales, puis récupère Ce qui fonctionne aujourd’hui, et ce qui ne fonctionne pas encore
Regardez la marque d’une fonctionnalité avant de compter dessus. « Fonctionne aujourd’hui » veut dire qu’elle marche dans la version actuelle et qu’elle est couverte par les suites de tests. « Optionnel » veut dire qu’elle marche une fois que vous avez installé ou configuré quelque chose, comme un virtualenv Python ou une clé d’API. « Prévu » veut dire qu’elle n’existe pas encore : n’en dépendez pas. Chaque page porte les trois mêmes marques, et tout ce qui n’est pas marqué fonctionne aujourd’hui.
Fonctionne aujourd’hui
- Documents, pièces jointes, chaque version gardée
- Recherche vectorielle, par mots-clés (BM25) et hybride
- Recherche par sous-chaîne et par expression régulière
- Requêtes BQL et abonnements en direct
- Réplication active-active : nœuds et navigateurs
- Branches et restauration à un instant donné
- Chiffrement au repos
- Espaces, sessions, jetons de capacité, passations
- Serveur REST et MCP
Optionnel, à installer
- Embeddings locaux (virtualenv Python)
- Fournisseurs d’embeddings dans le cloud (clé d’API)
- Reclassement (virtualenv Python)
- Moteur d’index FAISS (FAISS du système)
- Stockage des pièces jointes compatible S3
Prévu
- Requêtes fédérées en direct sur plusieurs contextes
- Fusion des classements et reclassement sur plusieurs contextes
- Inscription des contextes dans un catalogue