Beancount CLI rýchly štart

Vytvorte lokálny ledger a zaregistrujte svoj prvý nákup pomocou bea, príkazového riadku Beancount.io. Lokálne vedenie účtov nevyžaduje konto Beancount.io.

Tento tutoriál začína s 1 000 USD na čekovom konte. Po nákupe kávy za 12,50 USD skontrolujete zostatok 987,50 USD.

1. Zainštalujte príkaz​

S Homebrew na macOS alebo Linux:

brew install bex-co/tap/bea
bea --version

Ak nepoužívate Homebrew, nainštalujte uv a použite uv tool install beancount-io. Python balíček vyžaduje Python 3.12 alebo novší.

2. Vytvorte svoj ledger​

Vyberte nový priečinok. Tento príklad vytvára main.bean vnútri ~/my-books:

bea --no-input init ~/my-books --currency USD --date 2026-08-01 \
  --opening-balance "Assets:Checking 1000"
cd ~/my-books

Šablóna otvára bežné čekové, úsporové, hotovostné, kreditové, příjmové a výdavkové kontá. Počiatočný zostatok je kompenzovaný proti Equity:OpeningBalances.

Pre vaše vlastné knihy zvolte najstarší dátum, ktorý plánujete zapísať. Všetky šablónové kontá sa otvárajú v ten deň. Počiatočný zostatok musí opisovať konto v ten deň. Dlh na kreditovej karte používa negatívny zostatok.

init nikdy neprepisuje existujúcí ledger. Nové súbory sú privátné v POSIX systémoch: iba vlastník môže ich čítať a písať. Ak chcete ich zdieľať s vašou lokálnou skupinou, zmeňte explicitne povolenia pomocou chmod 640 main.bean.

Pre sprievodený štart namiesto toho spustite bea init ~/my-books v terminále. Majster sa pýta o vašej měně, dátume začiatku histórie a čekovém zostatku.

3. Zaregistrujte nákup​

bea add transaction --date 2026-08-02 --narration "Coffee" \
  --posting "Expenses:Dining 12.50" \
  --posting "Assets:Checking"

Výdavok používa USD měnu konta. Beancount vyplňuje druhý posting ako -12.50 USD. Ak chcete zaregistruať nákup, ktorý sa stal dnes, môžete preskočiť --date.

Každé pridanie je kontrolované proti kompletnému ledgeru predtým ako súbor je nahradený. Neznáme konto alebo nevyvážená transakcia produkuje chybu s guidance.

4. Skontrolujte výsledok​

bea check
bea list transaction --limit 10
bea report balance-sheet

Lista transakcíí zobrazí najnovšie záznamy na začiatku, s ich postingovými zostatkami. Bilans zobrazí 987.50 USD na čekovom konte.

Pre overenie tohto zostatku priamo:

bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"

Query tablice zachováju presnosť výsledka. Pre štruktúrovaný výstup umiestite globálny --json príkaz pred príkazom:

bea --json list transaction --limit 10

5. Udržujte svoje knihy v dobrom stave​

Spustite bea check po ručnom editovaní súboru. Spustite bea format main.bean pre porovnanie jeho stĺpcov. Použite bea format main.bean --check keď script má zlyhnúť, ak formátovanie je potrebné.

Pre prácu z iného priečinka vyberte root súbor explicitne:

bea --file ~/my-books/main.bean check

Root je vybraný pomocou --file, potom BEA_FILE, potom main.bean v pracovnom priečinku. Globálne opcie idú pred príkaz. Formátovanie má svoj vlastný súbor alebo priečinkový argument.

Pokračujte s vašimi vlastnými záznamami​

• Importujte bankovú exportáciu s preview a kontrolou duplicátov.
• Zistite príkazy a opcie pre kontá, zostatky, investície, reporty a automatizáciu.
• Organizujte ledger medzi súbormi. Použite --into pre zapis inkludovaného súboru pri validácii proti root.
• Použite browserové interface, ak preferujete formuláre namiesto príkazových riadkov.

Skontrolujte aktualizácie s bea upgrade --check. Spustite bea upgrade pre vyvolanie package managera, ktorý instaloval vašu kopiu. Použite bea --help alebo bea add transaction --help pre prehliadku opcíí v vašej instalovanej verzii.