Barrel
EN GitHub

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"}]}.
id: kb-142 document JSON, versions gardées pièces jointes fichiers, stockés par blocs vecteur calculé à partir des champs
Un identifiant les relie. Le vecteur suit chaque modification et chaque suppression du document, et la réplication emporte le document et ses fichiers vers les autres copies.

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.
Comment fonctionne la réplication, et comment elle est testée

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).

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.

  1. Votre applicationagents, workers, processus OTP

    appelle l’API barrel

  2. barrelenregistrements, recherche, branches

    stocke dans

  3. 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.

Démarrage rapide : embarqué

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.

  1. Agents et servicesclients MCP, curl, votre backend

    MCP sur /mcp, REST sur /db

  2. barrel_serverauthentification, jetons de capacité, espaces

    appelle

  3. 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.

Démarrage rapide : serveur

Navigateur

Une copie locale dans une application web. Lectures et écritures continuent de fonctionner hors ligne.

  1. Votre application webTypeScript

    lit et écrit en local

  2. barrel-litestocke dans le navigateur (OPFS)

    se synchronise via /db/:db/_sync

  3. 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.

Démarrage rapide : navigateur

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'">>).

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

État de chaque fonctionnalité

Haut et bas pour se déplacerEntrée pour ouvrir