Inici ràpid amb la CLI de Beancount

Creeu un llibre 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.

Aquest tutorial 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 superior. Homebrew aprovisiona el motor de comptabilitat durant la instal·lació. Amb PyPI, manteniu uv disponible: la primera ordre local descarrega el motor gestionat, i les ordres posteriors el reutilitzen sense connexió. No cal que instal·leu Beancount per separat.

2. Creeu el vostre llibre​

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 un import negatiu.

init mai no sobreescriu un llibre existent. Els fitxers nous són privats en sistemes POSIX: només el propietari els pot llegir i escriure. Per compartir-los amb el vostre grup d'usuari 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 completa l'altre assentament com a -12.50 USD. Podeu ometre --date per a compres fetes avui.

Cada addició es comprova contra el llibre complet abans que el fitxer se substitueixi. 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 d'assentament. El balanç de situació mostra 987.50 USD al compte corrent.

Per verificar aquest import directament:

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

Les taules de consulta conserven la precisió del resultat. Per a una sortida estructurada, poseu la marca 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 a mà. Executeu bea format -i main.bean per alinear les seves columnes in situ. Sense -i, el text formatat va a la sortida estàndard i el fitxer roman sense canvis. 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 amb --file, després BEA_FILE, després main.bean al directori de treball. Les opcions globals van abans de l'ordre. El formatat admet 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.
• Encarregueu dos treballs de comptabilitat a un agent extern amb indicacions copiables i equivalents de CLI.
• Compareu cinc eines de comptabilitat per a agents d'IA pel que fa a instal·lació, autenticació, abast, dades, vista prèvia, sortida i repeticions, amb fonts datades.
• Consulteu ordres i opcions per a comptes, saldos, inversions, informes i automatització.
• Organitzeu un llibre 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.