Inici ràpid amb la CLI de Beancount

Creeu un llibre major local i registreu la vostra primera compra amb bea, l'eina de línia d'ordres de Beancount.io. La comptabilitat local no requereix cap compte de Beancount.io.

Aquesta guia comença amb 1.000 USD al compte corrent. Després d'una compra de cafè de 12,50 USD, verificareu un saldo de 987,50 USD.

1. Instal·leu l'ordre​

Amb Homebrew a macOS o Linux:

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

Si no feu servir Homebrew, instal·leu uv i utilitzeu uv tool install beancount-io. El paquet de Python requereix Python 3.12 o més recent.

2. Creeu el vostre llibre major​

Trieu un directori nou. Aquest exemple crea main.bean dins de ~/my-books:

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

La plantilla obre comptes habituals de corrent, estalvis, efectiu, targeta de crèdit, ingressos i despeses. El saldo inicial es compensa amb Equity:OpeningBalances.

Per als vostres propis llibres, trieu la data més antiga que tingueu intenció de registrar. Tots els comptes de la plantilla s'obren en aquesta data. El saldo inicial ha de descriure el compte en aquell dia. El deute de la targeta de crèdit utilitza una quantitat negativa.

init mai sobreescriu un llibre major existent. Els fitxers nous són privats en sistemes POSIX: només el propietari pot llegir-los i escriure-hi. Per compartir amb el vostre grup d'usuaris local, canvieu explícitament els permisos amb chmod 640 main.bean.

Per a una configuració guiada, executeu bea init ~/my-books en un terminal. L'assistent us demana la moneda, la data d'inici de l'historial i el saldo del compte corrent.

3. Registreu una compra​

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

La despesa utilitza la moneda USD del compte. Beancount omple l'altra partida com a -12.50 USD. Podeu ometre --date per a compres fetes avui.

Cada afegit es comprova contra el llibre major complet abans de substituir el fitxer. Un compte desconegut o una transacció no equilibrada produeix un error amb orientació.

4. Comproveu el resultat​

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

La llista de transaccions mostra les entrades més recents primer, amb els seus imports de partida. El balanç de situació mostra 987.50 USD al compte corrent.

Per verificar aquesta quantitat directament:

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

Les taules de consulta preserven la precisió del resultat. Per a una sortida estructurada, poseu la bandera global --json abans de l'ordre:

bea --json list transaction --limit 10

5. Mantingueu els vostres llibres en bon estat​

Executeu bea check després d'editar el fitxer manualment. Executeu bea format main.bean per alinear les columnes. Utilitzeu bea format main.bean --check quan un script hagi de fallar si cal formatar.

Per treballar des d'un altre directori, seleccioneu el fitxer arrel explícitament:

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

L'arrel se selecciona mitjançant --file, després BEA_FILE, i després main.bean al directori de treball. Les opcions globals van abans de l'ordre. El formatat accepta el seu propi argument de fitxer o directori.

Continueu amb els vostres propis registres​

• Importeu una exportació bancària amb una vista prèvia i revisió de duplicats.
• Consulteu ordres i opcions per a comptes, saldos, inversions, informes i automatització.
• Organitzeu un llibre major en diversos fitxers. Utilitzeu --into per escriure un fitxer inclòs mentre valideu contra l'arrel.
• Utilitzeu la interfície de navegador si preferiu formularis a ordres de terminal.

Comproveu si hi ha actualitzacions amb bea upgrade --check. Executeu bea upgrade per invocar el gestor de paquets que va instal·lar la vostra còpia. Utilitzeu bea --help o bea add transaction --help per inspeccionar les opcions disponibles a la vostra versió instal·lada.