Ja dones al teu agent d'IA el teu codi font, el teu terminal i les teves sessions de depuració més difícils. Ara dona-li també els teus llibres — amb cada entrada que redacti passant per una vista prèvia que tu aproves i un validador que comprova les matemàtiques. L'eina de línia d'ordres bea s'instal·la amb dues comandes, funciona amb fitxers de llibre major en text pla a la teva pròpia màquina i no necessita cap compte per a la comptabilitat local.
Instal·la-ho en dues comandes
Hi ha dues maneres publicades d'obtenir la mateixa ordre. Tria la que s'adapti a la teva màquina i després confirma que respon amb la seva versió:
$ uv tool install beancount-io
$ brew install bex-co/tap/bea
$ bea --version
bea 0.1.0La distribució de Python és beancount-io i l'executable que instal·la és bea, actualment a la versió 0.1.0. La via uv funciona a qualsevol lloc amb Python 3.12 o més nou; la via Homebrew cobreix macOS i Linux. El tutorial complet es troba a la pàgina d'instal·lació, amb els mateixos passos a la guia d'inici ràpid de la CLI.
La primera tasca del teu agent triga minuts
No necessites un agent nou, un connector ni una migració de plataforma. Enganxa això a l'agent d'IA amb capacitat de shell que ja utilitzes, en un directori de demostració nou i buit:
Tens accés al shell i la CLI
beainstal·lada. Primer executabea --helpi llegeix què ofereix. Després, en un directori de demostració NOU i buit (no toquis cap llibre major existent): 1) crea un llibre major en USD obrint Assets:Checking amb 1000 el 2026-08-01; 2) afegeix una compra de 12,50 USD amb la narració "Coffee" a Expenses:Dining el 2026-08-02; 3) executabea check; 4) informa del saldo d'Assets:Checking juntament amb la consulta BQL exacta que has utilitzat. Resultat esperat: 987,50 USD.
Els mateixos passos com a ordres 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"Resultat esperat: Assets:Checking conté 987,50 USD — 1000 menys 12,50, validat per check i informat amb la consulta que ho ha calculat. Quan el teu agent et dona aquest número, ha fet el seu primer bucle tancat: redactar, validar, informar. La guia per a agents es basa en el mateix bucle amb dues receptes més completes — importar un CSV bancari amb revisió prèvia a la vista, i respondre una pregunta de saldo a partir de la sortida de la consulta.
Què necessites i a qui va dirigit
Un terminal, una connexió de xarxa i o bé Homebrew o bé uv amb Python 3.12 o més nou. Les ordres locals d'importació, consulta, informe i comprovació no necessiten cap compte de Beancount.io, i els teus fitxers de llibre major es queden en un directori que tu tries com a text pla que pots comparar, fer-ne còpies de seguretat i controlar versions.
Això s'adapta a fundadors tècnics que porten la comptabilitat de la seva pròpia startup, desenvolupadors independents que ja viuen al terminal i creadors d'agents que busquen un llibre major contra el qual un IA pugui redactar canvis sense escriptures silencioses. Si els teus llibres ja viuen en un producte al núvol, la resposta honesta és diferent — consulta la secció de comparació a continuació.
La via allotjada és opcional i separada
Res del que hi ha a dalt necessita un compte ni envia el teu llibre major a cap lloc. Dues coses extra sí que ho fan, i totes dues estan deliberadament separades de la instal·lació de la CLI:
bea askrespon preguntes sobre un llibre major local mitjançant el servei d'IA allotjat. Necessita l'extra ask —uv tool install 'beancount-io[ask]'— a més de les teves credencials de Beancount.io. La instal·lació per defecte omet les dependències d'IA fins que les demanis.- El servidor MCP i els llibres majors allotjats també inicien sessió amb el teu compte de Beancount.io per autoritzar l'accés. Les habilitats d'agent per a Beancount viuen al repositori del producte i es carreguen al teu agent per separat — instal·lar la CLI no les instal·la ni les configura.
Comença local; connecta l'allotjament només si ho vols.
Prova: un agent, tres files, llibres comprovats
Una afirmació de llançament només val el que val la seva reproducció. Per això, juntament amb la CLI, s'inclou un repte sintètic de tres files amb una resposta derivada de l'aritmètica abans que s'executés cap informe: els llibres s'obren l'2026-09-01 amb 1000 USD al compte corrent, l'extracte inclou un pagament de client de 2000,00 USD, una factura d'allotjament de −29,00 USD i una visita al cafè de −12,50 USD, i les respostes esperades són 2958,50 USD al compte corrent (1000 + 2000 − 29 − 12,50) i 1958,50 USD de benefici de setembre (2000 − 29 − 12,50).
Un verificador amb la CLI instal·lada executa tot el bucle en un directori temporal nou: la vista prèvia informa de 3 preparades i no escriu res, la primera aplicació escriu 3 entrades, una reimportació idèntica n'escriu 0 amb els bytes del llibre major preservats, una escriptura desequilibrada (−5 al compte corrent contra +4 a despeses) surt amb codi 1 amb els bytes preservats, i check retorna vàlid. Les entrades exactes es poden baixar com a main.bean, statement.csv i rules.toml.
Després, un agent real va executar el mateix repte: client muse 1.1.1 (Muse Code) amb el model muse-spark-1.3-contributor, sense capçalera, 22 crides d'eina, sortida 0, sense intervencions humanes — i, de manera crítica, sense rules.toml proporcionat, així que l'agent va derivar la seva pròpia categorització. Va previsualitzar 3 preparades, va aplicar 3 entrades, va executar una comprovació neta i va informar de 2958,50 USD al compte corrent i 1958,50 USD de benefici de setembre, tots dos reverificats després contra els valors esperats independents. El registre complet — el prompt real, cada crida d'eina i l'única fallada real que va diagnosticar ell mateix (un bloqueig de memòria cau en sandbox, arreglat apuntant XDG_CACHE_HOME dins del directori de treball) — es publica com a execució enregistrada, amb la transcripció crua al costat.
La sessió de terminal a continuació és una reproducció determinista del camí de treball d'aquesta execució, reconstruïda a partir de les baixades canòniques mitjançant demo-replay.sh — reescenifica les ordres, així que incorpora les regles de categorització per a la determinisme en lloc de rederivar-les. La sortida capturada a demo-replay.txt porta la mateixa informació que veure-la:
$ 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.Dues limitacions honestes acompanyen aquesta evidència. És una verificació de sortida de CLI d'una sola execució d'un sol client amb dades sintètiques — no és un benchmark de models, i no afirma res sobre altres clients ni sobre l'ús de producció sense supervisió. I un check que passa prova que el llibre major quadra, mai que l'agent hagi triat el compte correcte per al cafè: el judici de categoria és de l'agent, la validació estructural és de bea. Una joguina de tres files prova el bucle, no el judici.
Triar entre eines
Si tries un llibre major per a fluxos de treball d'agents en lloc d'estar convençut d'aquest, llegeix la comparació de cinc eines: Beancount.io, Xero, QuickBooks Online, Puzzle i hledger puntuats amb els mateixos set criteris de flux de treball d'agents — instal·lació, autenticació, abast de lectura/escriptura, dades locals versus al núvol, vista prèvia i validació, sortida estructurada i comportament d'importació repetida — amb fonts oficials datades comprovades el 2026-09-10. Beancount.io és l'única eina allà amb una execució de principi a fi observada al darrere; la pàgina ho diu, nomena el seu editor i etiqueta què no va provar.
On anar des d'aquí
- Pàgina d'instal·lació — les dues ordres, la primera tasca i les baixades del repte en un sol lloc.
- Guia d'inici ràpid de la CLI — instal·lació més l'exemple treballat de 987,50 USD.
- Guia per a agents — dues receptes: importació de CSV amb revisió prèvia a la vista i preguntes de saldo a partir de la sortida de la consulta.
- Execució enregistrada — la història completa de la prova amb metodologia, fallades i limitacions.
- Comparació de cinc eines — quina eina s'adapta a quin flux de treball d'agent.
Simplifica la teva gestió financera
La manera més ràpida de jutjar tot això és la demo de dalt: instal·la bea, enganxa la tasca a l'agent que ja utilitzes i comprova els 987,50 USD tu mateix. Beancount.io proporciona comptabilitat en text pla que manté cada saldo reproduïble i cada canvi revisable — sense caixes negres, sense dependència del proveïdor. Dóna al teu agent el seu primer llibre major i mira què et retorna.
