Dai al tuo agente AI un libro mastro
Trasforma un'attività in libri contabili verificabili. Dai al tuo agente con accesso alla shell il CLI bea per registrare transazioni, controllare il suo lavoro e restituire un saldo basato su testo semplice.
Installa bea
Scegli il tuo installer, poi verifica la versione. I libri locali non richiedono un account Beancount.io.
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS o Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDTesto semplice. Tuo da conservare.
File .bean locali che puoi leggere, confrontare e versionare con Git.
Un controllo prima di ogni modifica.
Le aggiunte CLI predefinite devono essere validate prima che il tuo registro venga sostituito.
Porta l'agente che usi.
Un agente con accesso alla shell, un'attività e comandi che puoi ispezionare.
Cosa ti serve
Un terminale, una connessione di rete e Homebrew o uv con Python 3.12 o successivo. La contabilità locale non richiede un account Beancount.io — questo entra in gioco solo per il passaggio opzionale ospitato di seguito.
bea --versionEsempio verificato con bea 0.1.0: la distribuzione Python è beancount-io e l'eseguibile che installa è bea.
Un piccolo compito. Un vero set di libri.
Inizia con 1,000 USD. Registra un caffè da 12.50 USD. Chiedi al tuo agente di controllare il registro e mostrare la query dietro la sua risposta.
Prompt del compito dell'agente
Hai accesso alla shell e la CLI `bea` installata. Prima esegui `bea --help` e leggi cosa offre. Poi, in una NUOVA directory demo vuota (non toccare alcun libro esistente): 1) crea un libro USD che apre Assets:Checking a 1000 il 2026-08-01; 2) aggiungi un acquisto di 12.50 USD narrato "Coffee" a Expenses:Dining il 2026-08-02; 3) esegui `bea check`; 4) riporta il saldo di Assets:Checking insieme alla query BQL esatta che hai usato. Risultato atteso: 987.50 USD.- Crea un nuovo registro demo
- Registra l'acquisto del caffè
- Controlla i libri e interroga il saldo
Risultato atteso: Assets:Checking contiene 987.50 USD.
Esegui tu stesso, comando per comando
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"Metti alla prova il tuo agente.
Tre transazioni bancarie. Una singola esecuzione registrata dell'agente. Scarica gli stessi input, riproduci il risultato e ispeziona cosa è successo lungo il percorso.
Leggi la registrazioneDati sintetici, verificati con bea 0.1.0. Una esecuzione osservata; il registro completo include errori e limitazioni.
Gli input esatti della sfida
Un registro iniziale, un estratto conto bancario e regole di categorizzazione.
Vai oltre la demo.
Due ricette copiabili si basano sulla demo sopra: importa un CSV bancario con categorie proposte dall'agente, poi rispondi a una domanda sul saldo dall'output della query. Ogni una abbina un prompt dell'agente con equivalenti CLI e risultati attesi.
Leggi le ricette dell'agenteStai scegliendo tra strumenti? Beancount.io è uno dei cinque confrontati secondo gli stessi criteri di flusso di lavoro per agenti, con fonti datate.
Leggi il confronto tra i cinque strumentiQualche chiarimento prima di iniziare.
I tuoi libri restano sulla tua macchina
Ogni comando di seguito funziona su file .bean di testo semplice in una directory che scegli tu. I nuovi file di libro mastro sono privati per il tuo utente e ogni aggiunta viene validata rispetto all'intero libro prima che il file venga sostituito — sul percorso CLI locale predefinito, un account sconosciuto o una transazione non bilanciata è un errore con indicazioni e il file viene lasciato intatto.
Ho bisogno di un account Beancount.io?
No, per nulla di questa pagina. Installare bea, creare un libro locale, registrare acquisti e controllare i saldi funziona senza account. Devi solo accedere per gli extra ospitati opzionali: bea ask, il server MCP e i libri ospitati.
L'installazione della CLI configura il mio agente AI?
No. L'installazione ti dà il comando bea; il tuo agente rimane esattamente com'è. Incolli l'attività sopra nell'agente con accesso alla shell che già usi e il caricamento delle competenze dell'agente è un passaggio separato.
Il mio libro lascia la mia macchina?
I comandi locali lavorano su file .bean locali e non effettuano chiamate di rete. Solo i comandi ospitati — bea cloud e bea ask, le cui chiamate al modello passano attraverso il proxy AI ospitato — comunicano con i servizi Beancount.io.
Cosa succede se il mio agente scrive una voce errata?
Sul percorso CLI locale predefinito, ogni aggiunta viene controllata rispetto all'intero libro prima che il file venga sostituito. Un account sconosciuto o una transazione non bilanciata fallisce con indicazioni e lascia il file intatto: fai eseguire all'agente bea check anche dopo qualsiasi modifica manuale.
Cosa serve esattamente a bea ask?
Due cose oltre a questa pagina: l'extra di dipendenza ask e le credenziali ospitate per accedere. L'installazione predefinita di bea omette intenzionalmente le dipendenze AI finché non le richiedi.
Connetti strumenti ospitati quando ti servono
I comandi CLI locali funzionano senza un account Beancount.io. L'aiuto AI ospitato e l'accesso MCP sono connessioni separate e opzionali.
bea ask risponde a domande su un libro locale tramite il servizio AI ospitato. Richiede l'extra ask — uv tool install 'beancount-io[ask]' — oltre alle tue credenziali Beancount.io.
Il server MCP e i libri ospitati accedono allo stesso modo con il tuo account Beancount.io per autorizzare l'accesso. Inizia in locale; collega l'hosting solo se lo desideri.
Le competenze dell'agente per Beancount vivono nel repository del prodotto e si caricano nel tuo agente separatamente: l'installazione della CLI non le installa né le configura.
Esplora la connessione MCPIl tuo agente può fare la contabilità. Tu puoi vedere il lavoro.
Inizia con un registro locale e un risultato verificabile.