Intégrée, serveur ou navigateur : la même base.
Barrel tourne dans votre release Erlang, derrière son propre serveur REST et MCP, ou comme copie locale dans une page web. L’enregistrement et le protocole de réplication sont les mêmes dans les trois cas, vous pouvez donc commencer par l’un et ajouter les autres.
La plupart des déploiements les combinent : des agents sur un serveur, des nœuds en périphérie en mode intégré, des utilisateurs dans le navigateur, tous synchronisés.
Comment ils se relient
Un seul protocole de synchronisation les relie. Un navigateur se synchronise avec un serveur ; serveurs et nœuds intégrés se répliquent entre eux dans les deux sens.
- Onglet du navigateur barrel-lite, OPFS
/db/:db/_sync, bearer
- barrel_server REST, MCP, synchronisation
barrel_rep sur HTTP
- Votre release barrel intégré
Choisir
Lisez une ligne pour comparer. Chaque colonne mène à son démarrage rapide.
| Question | Intégrée | Serveur | Navigateur |
|---|---|---|---|
| Choisissez-la quand | Vos agents et vos services sont des processus Erlang ou Elixir dans une même release. | Des clients dans d’autres langages, des agents en MCP ou d’autres nœuds doivent accéder aux données. | Une application web doit continuer à lire et écrire hors ligne. |
| Ce qui tourne | barrel comme bibliothèque dans votre VM. Aucun protocole réseau. | barrel_server : REST et MCP sur HTTP/1.1, HTTP/2 avec TLS, ou HTTP/3. | barrel-lite, un client TypeScript qui garde une copie locale. |
| Il vous faut | OTP 26 ou plus récent, un compilateur C et CMake pour les NIF (RocksDB, l’index vectoriel, l’index de trigrammes). | La même chose, construite avec le profil server ; port 8080 par défaut. | Un barrel_server avec lequel synchroniser, CORS activé, et un jeton de capacité pour le navigateur. |
| Les données vivent dans | RocksDB sous le data_dir de docdb, les vecteurs sous le db_path du magasin. | Le data_dir du serveur. Les bases s’ouvrent au premier usage et se ferment quand elles sont inactives. | OPFS quand le navigateur le propose, sinon la mémoire. La copie du serveur fait foi. |
| Recherche | Tout : vectorielle, BM25, hybride, fonctions de table BQL, sous-chaîne et expression régulière. | Vectorielle, BM25 et hybride en REST et MCP ; sous-chaîne et expression régulière en MCP seulement. | BQL local sur les documents et recherche vectorielle exhaustive sur les vecteurs synchronisés. Mots-clés et hybride passent par le serveur. |
| Réplication | barrel_rep et barrel_rep_tasks sur la base de documents, dans la VM ou sur HTTP. | Sert le protocole de synchronisation sur /db/:db/_sync, et lance des tâches vers d’autres nœuds. | Push, pull et synchronisation en direct avec un serveur, depuis l’onglet leader seulement. |
| Contrôle d’accès | Votre code. Le chiffrement par base est la frontière entre clients. | Bearer, jetons de capacité, requêtes signées, mTLS. Ouvert tant que vous ne fixez pas auth. | Bearer seulement : un jeton de capacité limité à un espace. |
| Attention à | Le chemin des vecteurs par défaut est relatif au répertoire courant ; fixez db_path. Le magasin de vecteurs est lié au processus qui l’a ouvert. | Les bases par défaut ont BM25 désactivé ; fixez open_opts. Les erreurs de configuration de la recherche répondent 500. | Les écritures non vidées sur disque sont perdues en cas de crash, et le navigateur peut évincer le stockage. Pas encore publié sur npm. |
Des pièces optionnelles, dans chacun d’eux
Absentes du build par défaut. Ajoutez-les là où vous en avez besoin.
-
Embeddings, locaux ou dans le cloud
Un fournisseur de
barrel_embed: Ollama, un virtualenv Python pour des modèles locaux, ou une clé d’API cloud. -
Reclassement
barrel_rerank: Python 3 avec transformers et torch, environ 2 Go, modèle téléchargé au premier usage. -
Index FAISS
rebar3 as faiss compileavec la bibliothèque C++ FAISS installée sur le système. Linux, macOS et BSD ; pas de build Windows. -
Pièces jointes S3
rebar3 as s3 compile. Testé avec RustFS et Garage. Non couvert par le chiffrement au repos.
Démarrer
Intégrée
{deps, [{barrel, "~> 1.14"}]}. {ok, _} = application:ensure_all_started(barrel),
{ok, Db} = barrel:open(<<"kb">>, #{vectordb => #{
db_path => "data/kb_vec", dimensions => 768}}),
{ok, _} = barrel:put_doc(Db, #{<<"id">> => <<"kb-142">>,
<<"title">> => <<"Reset a locked account">>}). Serveur
Depuis l’umbrella. Pendant le développement, rebar3 as server shell puis application:ensure_all_started(barrel_server) fait la même chose.
rebar3 as server,prod release -n barrel_server
cd _build/server+prod/rel/barrel_server
bin/barrel_server foreground
curl localhost:8080/health {"status":"ok"} Navigateur
barrel-lite n’est pas encore sur npm : construisez-le depuis clients/barrel-lite dans le dépôt.
import { Database } from "barrel-lite";
const db = await Database.open("notes", {
remote: { url: "https://edge.example:8080",
db: "sp_...", token: "bsp_..." },
multiTab: true,
});
await db.put({ id: "n1", title: "hello" });
await db.sync(); // push local writes, then pull Limites
- barrel-lite 0.1.0 n’est pas publié sur npm ; vous le construisez depuis le dépôt.
- L’API intégrée n’expose pas la réplication : appelez
barrel_repsur la base de documents. - Le serveur n’a pas d’option pour couper son écoute HTTP ; pour servir les routes barrel depuis votre propre service livery, montez
barrel_server_api:routes/1. - Les écoutes HTTP/3 ne vérifient pas les certificats clients ; utilisez HTTP/1.1 ou HTTP/2 avec TLS pour mTLS.
- Dans le navigateur, le stockage est un cache : c’est la synchronisation qui rend une écriture durable.