Pre technických zakladateľov, vývojárov a staviteľov agentov

Dajte svojmu AI agentovi účtovnú knihu

Nainštalujte nástroj príkazového riadka bea a potom vložte jednu úlohu do shellového AI agenta, ktorého už používate. O chvíľu vám vráti overenú lokálnu knihu – bez potreby účtu Beancount.io.

Inštalácia bea Spustiť ukážku

Inštalácia bea

Dva publikované spôsoby, ako získať rovnaký príkaz. Vyberte ten, ktorý vyhovuje vášmu počítaču, a potom overte, že odpovedá svojou verziou.

Pomocou uv (kdekoľvek s Python 3.12 alebo novším)

uv tool install beancount-io

Pomocou Homebrew (macOS alebo Linux)

brew install bex-co/tap/bea

bea --version

Príklad overený s bea 0.1.0: Python distribúcia je beancount-io a spustiteľný súbor, ktorý inštaluje, je bea.

Čo potrebujete

Terminál, sieťové pripojenie a buď Homebrew alebo uv s Python 3.12 alebo novším. Lokálne účtovníctvo nevyžaduje účet Beancount.io – ten prichádza na rad iba pri voliteľnom hostovanom kroku nižšie.

Vaše knihy zostávajú na vašom počítači

Každý príkaz nižšie pracuje s obyčajnými textovými súbormi .bean v adresári, ktorý si zvolíte. Nové súbory knihy sú súkromné pre vášho používateľa a každý prírastok je overený proti celej knihe predtým, ako je súbor nahradený – na predvolenej lokálnej ceste CLI je neznámy účet alebo nevyvážená transakcia chybou s usmernením a súbor zostane nedotknutý.

Prvá úloha vášho agenta

Vložte toto do svojho agenta. Začína s 1,000 USD na bežnom účte, zaznamená kávu za 12.50 USD, overí knihu a nahlási zostatok spolu s použitým dotazom.

Výzva na úlohu agenta

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.

Rovnaké kroky ako obyčajné príkazy

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"

Očakávaný výsledok: Assets:Checking má 987.50 USD.

Prečítajte si rýchly štart CLI

Voliteľné: hostovaná AI pomoc

Nič vyššie nevyžaduje účet ani neposiela vašu knihu nikam. Dve voliteľné funkcie to vyžadujú a obe sú oddelené od inštalácie CLI.

bea ask odpovedá na otázky o lokálnej knihe prostredníctvom hostovanej AI služby. Vyžaduje extra ask – uv tool install 'beancount-io[ask]' – plus vaše prihlasovacie údaje Beancount.io.

MCP server a hostované knihy sa tiež prihlasujú pomocou vášho účtu Beancount.io na autorizáciu prístupu. Začnite lokálne; pripojte hosting, len ak ho chcete.

Agentské zručnosti pre Beancount žijú v repozitári produktu a načítajú sa do vášho agenta samostatne – inštalácia CLI ich nenainštaluje ani nenakonfiguruje.

Otázky, ktoré kladú stavitelia agentov

Potrebujem účet Beancount.io?

Nie pre nič na tejto stránke. Inštalácia bea, vytvorenie lokálnej knihy, zaznamenávanie nákupov a kontrola zostatkov fungujú bez účtu. Prihlasujete sa iba pre voliteľné hostované funkcie: bea ask, MCP server a hostované knihy.

Nastaví inštalácia CLI môjho AI agenta?

Nie. Inštalácia vám poskytne príkaz bea; váš agent zostane presne taký, aký je. Vy vložíte vyššie uvedenú úlohu do shellového agenta, ktorého už používate, a načítanie agentských zručností je samostatný krok.

Opustí moja kniha môj počítač?

Lokálne príkazy pracujú s lokálnymi súbormi .bean a nevykonávajú žiadne sieťové volania. Iba hostované príkazy – bea cloud a bea ask, ktorých volania modelov prebiehajú cez hostovaný AI proxy – komunikujú so službami Beancount.io.

Čo sa stane, ak môj agent zapíše zlý záznam?

Na predvolenej lokálnej ceste CLI sa každý prírastok skontroluje proti celej knihe predtým, ako je súbor nahradený. Neznámy účet alebo nevyvážená transakcia zlyhá s usmernením a nechá váš súbor nedotknutý – požiadajte agenta, aby spustil bea check aj po akomkoľvek ručnom úprave.

Čo presne bea ask potrebuje?

Dve veci okrem tejto stránky: extra závislosť ask a hostované prihlasovacie údaje na prihlásenie. Predvolená inštalácia bea zámerne vynecháva AI závislosti, kým o ne nepožiadate.

Začnite kávou, zostaňte pre knihy

Jedna inštalácia, jedna vložená úloha, jeden overený zostatok – potom pokračujte s úplným rýchlym štartom.

Prečítajte si rýchly štart CLI