Barrel
EN GitHub

Choisir un déploiement

Barrel tourne à trois endroits : dans votre release Erlang, comme serveur HTTP, et comme copie locale dans un navigateur web. Vous pouvez les combiner, puisqu’ils se répliquent entre eux : un serveur peut se synchroniser avec des navigateurs et avec d’autres serveurs, et chaque copie accepte des écritures. Servez-vous de cette page pour choisir par où commencer, selon vos clients et l’endroit où vos données doivent vivre.

Les trois options

Embarqué

En mode embarqué, la bibliothèque barrel tourne dans votre propre release Erlang ou Elixir, et votre code l’appelle comme des fonctions. Il convient à une application écrite en Erlang ou en Elixir qui possède ses données, comme un environnement d’agents sur un appareil en périphérie. Vous obtenez l’API complète sans saut réseau : mode enregistrement, timeline, espaces. En contrepartie, seul le code de la même release peut atteindre les données, et rien n’impose de règles d’accès entre les parties de ce code.

Serveur

barrel_server fait tourner Barrel comme un service et le sert sur HTTP : une API REST/JSON et un point d’accès MCP que les agents appellent comme des outils. Il convient aux clients écrits dans d’autres langages, aux clients sur d’autres machines et aux agents. En contrepartie, vous avez un service à faire tourner et à sécuriser : chaque appel traverse le réseau, et le serveur n’a aucune authentification tant que vous ne la configurez pas. Vous pouvez le lancer depuis son image Docker ou une archive tar de release sans rien compiler ; voir Installer.

barrel-lite garde une copie d’une base dans une application web : les lectures et les écritures sont locales et continuent de fonctionner hors ligne. Il convient à une application web qui doit rester utilisable sans réseau. En contrepartie, il lui faut un barrel_server avec qui se synchroniser, le navigateur peut effacer sa copie, et la recherche vectorielle, par mot-clé et hybride s’exécute sur le serveur, pas en local.

Choisir

Ce tableau associe un besoin à l’option qui y répond.

Si vous avez besoin deUtilisezPourquoi
Votre application est en Erlang ou Elixir et possède les donnéesbarrel embarquéAucun saut réseau, API complète, mode enregistrement, timeline
Des clients dans d’autres langages, ou sur d’autres machinesbarrel_serverREST/JSON sur HTTP/1.1, HTTP/2 ou HTTP/3
Un agent qui lit et écrit les donnéesbarrel_serverPoint d’accès MCP sur /mcp avec 39 outils
Une application web qui fonctionne hors lignebarrel-lite et barrel_serverStockage local dans le navigateur, synchronisé avec le serveur
Plusieurs sites ou appareils qui acceptent tous des écrituresN’importe lequel, en réplicationChaque copie accepte des écritures et converge
Documents et synchronisation seulement, sans vecteursbarrel_docdbDépendance plus légère, même réplication
Sous-chaîne exacte ou regex sur les documentsbarrel_ngram, ou barrel_serverLe serveur l’expose comme outil ngram_search

Ce que donne chaque mode

Ce tableau indique les fonctions de chaque mode : vérifiez que celui que vous avez choisi couvre vos besoins.

EmbarquéServeurNavigateur
Documents, BQLouiouioui, BQL local
Recherche vectorielle, BM25, hybrideouiouisur le serveur, via queryRemote ; cosinus local sur les vecteurs synchronisés
Pièces jointesouiouioui
Réplicationbarrel_reproutes _syncpush et pull vers un serveur
Branche, fusion, état passéouiroutes _timelinenon
Espaces, sessions, passationsbarrel_spaces/spaces, /handoffs, MCPnon
Authentificationdans le processus, aucunebearer, jetons de capacité, requêtes signées, mTLSbearer ou jeton de capacité
Chiffrement au reposouioui, via open_optsnon

À savoir avant de choisir

Voici les limites qui changent le plus souvent un choix.

  • Embarqué veut dire que votre processus détient les données. Le stockage vectoriel est lié au processus qui l’ouvre. Ouvrez les bases à longue durée de vie via barrel_dbs ou avec store_supervised => true. Voir Embarquer barrel dans une application Erlang.
  • Les jetons de capacité sont appliqués par le serveur. Dans le processus, n’importe quel code peut ouvrir n’importe quel espace. Si des agents doivent rester séparés, placez-les derrière barrel_server. Voir Espaces et capacités.
  • La copie du navigateur est un cache. Le navigateur peut l’effacer ; le serveur détient la copie durable.
  • Les vecteurs ne se répliquent pas. Chaque copie reconstruit son propre index à partir des documents, en mode enregistrement.
  • Un nœud n’est pas un cluster. Il n’y a ni placement ni bascule automatiques. C’est vous qui choisissez quelles copies se répliquent avec lesquelles.

Ensuite

Traduit de la page anglaise: /docs/start/choose-deployment/ Modifier cette page Voir en Markdown

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