Per a fundadors tècnics, desenvolupadors i creadors d'agents
Dona un llibre de comptes al teu agent d'IA
Instal·la l'eina de línia d'ordres bea, després enganxa una tasca a l'agent d'IA amb capacitat de shell que ja utilitzes. En pocs minuts, et retornarà un llibre de comptes local validat: no cal cap compte de Beancount.io.
Instal·la bea
Dues maneres publicades d'obtenir el mateix comandament. Tria la que s'adapti a la teva màquina i després confirma que respon amb la seva versió.
Amb uv (a qualsevol lloc amb Python 3.12 o superior)
uv tool install beancount-ioAmb Homebrew (macOS o Linux)
brew install bex-co/tap/beabea --versionExemple verificat amb bea 0.1.0: la distribució de Python és beancount-io i l'executable que instal·la és bea.
Què necessites
Un terminal, una connexió de xarxa i Homebrew o uv amb Python 3.12 o superior. La comptabilitat local no requereix cap compte de Beancount.io: això només entra en joc per al pas opcional allotjat a continuació.
Els teus llibres es mantenen a la teva màquina
Cada comandament següent funciona amb fitxers .bean de text net en un directori que triïs. Els nous fitxers de llibre són privats per al teu usuari, i cada addició es valida contra el llibre complet abans de substituir el fitxer: a la ruta CLI local per defecte, un compte desconegut o una transacció no equilibrada és un error amb orientació, i el fitxer es deixa intacte.
La primera tasca del teu agent
Enganxa això al teu agent. Comença amb 1,000 USD al compte corrent, registra un cafè de 12.50 USD, valida el llibre i informa del saldo amb la consulta que ha utilitzat.
Indicació de la tasca de l'agent
You have shell access and the `bea` CLI installed. First run `bea --help` and read what it offers. Then, in a NEW empty demo directory (do not touch any existing ledger): 1) create a USD ledger opening Assets:Checking at 1000 on 2026-08-01; 2) add a 12.50 USD purchase narrated "Coffee" to Expenses:Dining on 2026-08-02; 3) run `bea check`; 4) report the Assets:Checking balance together with the exact BQL query you used. Expected result: 987.50 USD.Els mateixos passos com a comandaments 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.
Llegeix la guia d'inici ràpid de la CLIOpcional: ajuda d'IA allotjada
Res del que hi ha a dalt requereix cap compte ni envia el teu llibre a cap lloc. Dues opcions addicionals sí que ho fan, i ambdues són independents de la instal·lació de la CLI.
bea ask respon preguntes sobre un llibre local a través del servei d'IA allotjat. Necessita l'extra ask — uv tool install 'beancount-io[ask]' — a més de les teves credencials de Beancount.io.
El servidor MCP i els llibres allotjats també inicien sessió amb el teu compte de Beancount.io per autoritzar l'accés. Comença localment; connecta l'allotjament només si ho vols.
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.
Preguntes que es fan els creadors d'agents
Necessito un compte de Beancount.io?
No per a res d'aquesta pàgina. Instal·lar bea, crear un llibre local, registrar compres i comprovar saldos funciona sense cap compte. Només has d'iniciar sessió per a les opcions allotjades opcionals: bea ask, el servidor MCP i els llibres allotjats.
Instal·lar la CLI configura el meu agent d'IA?
No. Instal·lar et proporciona el comandament bea; el teu agent es manté exactament com està. Enganxes la tasca anterior a l'agent amb capacitat de shell que ja utilitzes, i carregar habilitats d'agent és un pas separat.
El meu llibre surt de la meva màquina?
Els comandaments locals funcionen amb fitxers .bean locals i no fan cap crida de xarxa. Només els comandaments allotjats — bea cloud i bea ask, les crides de model dels quals passen pel proxy d'IA allotjat — es comuniquen amb els serveis de Beancount.io.
Què passa si el meu agent escriu una entrada incorrecta?
A la ruta CLI local per defecte, cada addició es comprova contra el llibre complet abans de substituir el fitxer. Un compte desconegut o una transacció no equilibrada falla amb orientació i deixa el teu fitxer intacte: també fes que l'agent executi bea check després de qualsevol edició manual.
Què necessita exactament bea ask?
Dues coses més enllà d'aquesta pàgina: l'extra de dependències ask i credencials allotjades per iniciar sessió. La instal·lació per defecte de bea omet intencionadament les dependències d'IA fins que les demanis.
Comença amb un cafè, queda't pels llibres
Una instal·lació, una tasca enganxada, un saldo verificat: després continua amb la guia d'inici ràpid completa.