Vous confiez déjà à votre agent IA votre codebase, votre terminal et vos sessions de débogage les plus difficiles. Confiez-lui maintenant vos livres comptables — chaque écriture qu'il rédige passant par un aperçu que vous approuvez et un validateur qui vérifie les calculs. L'outil en ligne de commande bea s'installe en deux commandes, fonctionne sur des fichiers de grand livre en texte plain sur votre propre machine, et ne nécessite aucun compte pour la tenue de livres locale.
Installez-le en deux commandes
Il existe deux méthodes publiées pour obtenir la même commande. Choisissez celle qui convient à votre machine, puis confirmez qu'elle répond avec sa version :
$ uv tool install beancount-io
$ brew install bex-co/tap/bea
$ bea --version
bea 0.1.0La distribution Python est beancount-io et l'exécutable qu'elle installe est bea, actuellement en version 0.1.0. Le chemin uv fonctionne partout avec Python 3.12 ou plus récent ; le chemin Homebrew couvre macOS et Linux. La procédure complète se trouve sur la page d'installation, avec les mêmes étapes dans le démarrage rapide du CLI.
La première tâche de votre agent prend quelques minutes
Vous n'avez pas besoin d'un nouvel agent, d'un plugin ou d'une migration de plateforme. Collez ceci dans l'agent IA compatible shell que vous utilisez déjà, dans un nouveau répertoire de démonstration vide :
Vous avez accès au shell et le CLI
beaest installé. Commencez par exécuterbea --helpet lisez ce qu'il propose. Ensuite, dans un NOUVEAU répertoire de démonstration vide (ne touchez à aucun grand livre existant) : 1) créez un grand livre en USD ouvrant Assets:Checking à 1000 le 2026-08-01 ; 2) ajoutez un achat de 12,50 USD avec la narration "Coffee" à Expenses:Dining le 2026-08-02 ; 3) exécutezbea check; 4) rapportez le solde de Assets:Checking ainsi que la requête BQL exacte que vous avez utilisée. Résultat attendu : 987,50 USD.
Les mêmes étapes sous forme de commandes simples :
$ bea --no-input init demo-books --currency USD --date 2026-08-01 --opening-balance "Assets:Checking 1000"
$ cd demo-books
$ bea add transaction --date 2026-08-02 --narration "Coffee" --posting "Expenses:Dining 12.50" --posting "Assets:Checking"
$ bea check
$ bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"Résultat attendu : Assets:Checking contient 987,50 USD — 1000 moins 12,50, validé par check et rapporté avec la requête qui l'a calculé. Lorsque votre agent vous remet ce chiffre, il a effectué sa première boucle fermée : rédaction, validation, rapport. Le guide de l'agent s'appuie sur la même boucle avec deux recettes plus complètes — importation d'un CSV bancaire avec examen préalable à l'aperçu, et réponse à une question de solde à partir de la sortie de requête.
Ce dont vous avez besoin, et à qui cela s'adresse
Un terminal, une connexion réseau, et soit Homebrew, soit uv avec Python 3.12 ou plus récent. Les commandes locales d'importation, de requête, de rapport et de vérification ne nécessitent aucun compte Beancount.io, et vos fichiers de grand livre restent dans un répertoire de votre choix sous forme de texte plain que vous pouvez différencier, sauvegarder et versionner.
Cela s'adresse aux fondateurs techniques qui tiennent leurs propres livres comptables de startup, aux développeurs indépendants qui vivent déjà dans un terminal, et aux créateurs d'agents qui cherchent un grand livre contre lequel un IA peut rédiger des modifications sans écritures silencieuses. Si vos livres vivent déjà dans un produit cloud, la réponse honnête est différente — voir la section de comparaison ci-dessous.
Le chemin hébergé est facultatif et séparé
Rien de ce qui précède ne nécessite un compte ni n'envoie votre grand livre où que ce soit. Deux éléments supplémentaires le font, et les deux sont délibérément séparés de l'installation du CLI :
bea askrépond à des questions sur un grand livre local via le service IA hébergé. Il nécessite l'option supplémentaire ask —uv tool install 'beancount-io[ask]'— ainsi que vos identifiants Beancount.io. L'installation par défaut omet les dépendances IA jusqu'à ce que vous les demandiez.- Le serveur MCP et les grands livres hébergés se connectent également avec votre compte Beancount.io pour autoriser l'accès. Les compétences d'agent pour Beancount vivent dans le référentiel produit et se chargent dans votre agent séparément — installer le CLI ne les installe ni ne les configure.
Commencez en local ; connectez l'hébergement uniquement si vous le souhaitez.
Preuve : un agent, trois lignes, livres vérifiés
Une affirmation de lancement ne vaut que par sa reproduction. Ainsi, avec le CLI est fourni un défi synthétique à trois lignes avec une réponse dérivée de l'arithmétique avant que tout rapport ne soit exécuté : les livres s'ouvrent le 2026-09-01 avec 1000 USD en checking, le relevé porte un paiement client de 2000,00 USD, une facture d'hébergement de −29,00 USD et une visite de café de −12,50 USD, et les réponses attendues sont 2958,50 USD en checking (1000 + 2000 − 29 − 12,50) et 1958,50 USD de bénéfice de septembre (2000 − 29 − 12,50).
Un vérificateur avec CLI installé exécute toute la boucle dans un nouveau répertoire temporaire : l'aperçu rapporte 3 prêts et n'écrit rien, la première application écrit 3 écritures, une réimportation identique écrit 0 avec octets du grand livre préservés, une écriture déséquilibrée (−5 checking contre +4 dining) sort avec le code 1 avec octets préservés, et check retourne valide. Les entrées exactes sont téléchargeables sous main.bean, statement.csv et rules.toml.
Ensuite, un agent réel a exécuté le même défi : client muse 1.1.1 (Muse Code) avec le modèle muse-spark-1.3-contributor, sans tête, 22 appels d'outils, sortie 0, aucune intervention humaine — et surtout, aucun rules.toml fourni, donc l'agent a dérivé sa propre catégorisation. Il a prévisualisé 3 prêts, appliqué 3 écritures, exécuté une vérification propre, et a rapporté 2958,50 USD en checking et 1958,50 USD de bénéfice de septembre, tous deux re-vérifiés ensuite par rapport aux valeurs attendues indépendantes. L'enregistrement complet — invite réelle, chaque appel d'outil, et la seule véritable défaillance qu'il a diagnostiquée lui-même (un verrou de cache en sandbox, corrigé en pointant XDG_CACHE_HOME vers le répertoire de travail) — est publié comme exécution enregistrée, avec la transcription brute à côté.
La session de terminal ci-dessous est une relecture déterministe du chemin de travail de cette exécution, reconstruite à partir des téléchargements canoniques par demo-replay.sh — elle rejoue les commandes, donc elle intègre les règles de catégorisation pour le déterminisme plutôt que de les redériver. La sortie capturée dans demo-replay.txt porte la même information que de la regarder :
$ bea --version
bea 0.1.0
$ bea import (preview)
csv → Assets:Checking: 3 ready, 0 exact duplicates, 0 possible duplicates
$ bea import --apply
Wrote 3 entries to $WORK/books/main.bean.
$ bea check
$WORK/books/main.bean: no errors
$ bea balance Assets:Checking
Checking 2,958.50 USD
$ bea report income-statement -t 2026-09
Net Profit: 1,958.50 USD
checking: 2958.50 USD (expected)
profit: 1958.50 USD (expected)
REPLAY OK: preview 3/0, applied 3, check clean, 2958.50 / 1958.50 USD.Deux limites honnêtes accompagnent ces preuves. Il s'agit d'une vérification de sortie CLI d'une seule exécution d'un client sur des données synthétiques — pas un benchmark de modèle, et cela ne prétend rien sur d'autres clients ou une utilisation de production non supervisée. Et un check réussi prouve que le grand livre s'équilibre, jamais que l'agent a choisi le bon compte pour le café : le jugement de catégorie est celui de l'agent, la validation structurelle est celle de bea. Un jouet à trois lignes teste la boucle, pas le jugement.
Choisir entre les outils
Si vous choisissez un grand livre pour les flux de travail d'agents plutôt que d'être convaincu par celui-ci, lisez la comparaison de cinq outils : Beancount.io, Xero, QuickBooks Online, Puzzle et hledger évalués sur les mêmes sept critères de flux de travail d'agents — installation, authentification, portée de lecture/écriture, données locales ou cloud, aperçu et validation, sortie structurée, et comportement d'importation répétée — avec des sources officielles datées vérifiées le 2026-09-10. Beancount.io est le seul outil là-bas avec une exécution de bout en bout observée derrière lui ; la page le dit, nomme son éditeur et étiquette ce qu'elle n'a pas testé.
Où aller ensuite
- Page d'installation — les deux commandes, la première tâche et les téléchargements du défi en un seul endroit.
- Démarrage rapide du CLI — installation plus l'exemple travaillé de 987,50 USD.
- Guide de l'agent — deux recettes : importation CSV avec examen préalable à l'aperçu, et questions de solde à partir de la sortie de requête.
- Exécution enregistrée — l'histoire complète de la preuve avec méthodologie, défaillances et limites.
- Comparaison de cinq outils — quel outil convient à quel flux de travail d'agent.
Simplifiez votre gestion financière
Le moyen le plus rapide de juger tout cela est la démo ci-dessus : installez bea, collez la tâche dans l'agent que vous utilisez déjà, et vérifiez les 987,50 USD vous-même. Beancount.io fournit une comptabilité en texte plain qui garde chaque solde reproductible et chaque changement révisable — pas de boîtes noires, pas de verrouillage fournisseur. Offrez à votre agent son premier grand livre et voyez ce qu'il vous rend.
