Per fondatori tecnici, sviluppatori e costruttori di agenti
Dai al tuo agente AI una contabilità
Installa lo strumento a riga di comando bea, poi incolla un compito nell'agente AI con accesso alla shell che già usi. In pochi minuti ti restituisce una contabilità locale validata — nessun account Beancount.io richiesto.
Installa bea
Due modi pubblicati per ottenere lo stesso comando. Scegli quello adatto alla tua macchina, poi conferma che risponda con la sua versione.
Con uv (ovunque con Python 3.12 o successivo)
uv tool install beancount-ioCon Homebrew (macOS o Linux)
brew install bex-co/tap/beabea --versionEsempio verificato con bea 0.1.0: la distribuzione Python è beancount-io e l'eseguibile che installa è bea.
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 — entra in gioco solo per il passo opzionale ospitato qui sotto.
I tuoi libri restano sulla tua macchina
Ogni comando qui sotto funziona su file .bean in testo semplice in una directory che scegli tu. I nuovi file di contabilità sono privati per il tuo utente e ogni aggiunta viene validata rispetto alla contabilità completa prima che il file venga sostituito — sul percorso CLI locale predefinito, un conto sconosciuto o una transazione sbilanciata è un errore con indicazioni e il file viene lasciato intatto.
Il primo compito del tuo agente
Incolla questo nel tuo agente. Inizia con 1,000 USD in conto corrente, registra un caffè da 12.50 USD, valida la contabilità e riporta il saldo con la query utilizzata.
Prompt del compito dell'agente
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.Gli stessi passaggi come comandi semplici
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"Risultato atteso: Assets:Checking contiene 987.50 USD.
Leggi la guida rapida CLIOpzionale: assistenza AI ospitata
Niente di quanto sopra richiede un account o invia la tua contabilità da qualche parte. Due extra opzionali lo richiedono, ed entrambi sono separati dall'installazione della CLI.
bea ask risponde a domande su una contabilità 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 le contabilità ospitate accedono anch'essi 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 — installare la CLI non le installa né le configura.
Domande che i costruttori di agenti si pongono
Ho bisogno di un account Beancount.io?
No, per qualsiasi cosa in questa pagina. Installare bea, creare una contabilità locale, registrare acquisti e controllare i saldi funziona tutto senza account. Devi accedere solo per gli extra ospitati opzionali: bea ask, il server MCP e le contabilità ospitate.
L'installazione della CLI configura il mio agente AI?
No. L'installazione ti dà il comando bea; il tuo agente resta esattamente com'è. Incolli il compito sopra nell'agente con accesso alla shell che già usi e caricare le competenze dell'agente è un passaggio separato.
La mia contabilità lascia la mia macchina?
I comandi locali funzionano su file .bean locali e non effettuano chiamate di rete. Solo i comandi ospitati — bea cloud e bea ask, le cui chiamate ai modelli 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 alla contabilità completa prima che il file venga sostituito. Un conto sconosciuto o una transazione sbilanciata fallisce con indicazioni e lascia il tuo file intatto — fai eseguire all'agente bea check anche dopo qualsiasi modifica manuale.
Di cosa ha esattamente bisogno 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.
Inizia con un caffè, resta per i libri
Un'installazione, un compito incollato, un saldo verificato — poi continua con la guida rapida completa.