Geef uw AI-agent een grootboek
Maak van een taak boekhouding die je kunt controleren. Geef je shell-capabele agent de bea-CLI om transacties vast te leggen, het werk te controleren en een saldo terug te geven dat is gebaseerd op platte tekst.
Installeer bea
Kies je installatieprogramma en controleer daarna de versie. Lokale boeken hebben geen Beancount.io-account nodig.
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS of Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDPlatte tekst. Van jou om te bewaren.
Lokale .bean-bestanden die je kunt lezen, diffen en versiebeheren met Git.
Een controle vóór elke wijziging.
Standaard CLI-toevoegingen moeten valideren voordat je grootboek wordt vervangen.
Neem de agent mee die jij gebruikt.
Een shell-capabele agent, één taak en opdrachten die je kunt controleren.
Wat u nodig heeft
Een terminal, een netwerkverbinding, en ofwel Homebrew ofwel uv met Python 3.12 of nieuwer. Lokale boekhouding vereist geen Beancount.io-account — dat komt pas aan bod bij de optionele gehoste stap hieronder.
bea --versionVoorbeeld geverifieerd met bea 0.1.0: de Python-distributie is beancount-io en het uitvoerbare bestand dat het installeert is bea.
Eén kleine taak. Een echte set boeken.
Begin met 1,000 USD. Leg een koffie van 12.50 USD vast. Vraag je agent om het grootboek te controleren en de query achter het antwoord te tonen.
Agent-taakprompt
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.- Maak een nieuw demo-grootboek
- Leg de koffieaankoop vast
- Controleer de boeken en vraag het saldo op
Verwacht resultaat: Assets:Checking bevat 987.50 USD.
Voer het zelf uit, opdracht voor opdracht
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"Stel je agent op de proef.
Drie banktransacties. Eén vastgelegde agentrun. Download dezelfde invoer, reproduceer het resultaat en inspecteer wat er onderweg is gebeurd.
Lees de opgenomen runSynthetische gegevens, geverifieerd met bea 0.1.0. Eén waargenomen run; het volledige verslag bevat fouten en beperkingen.
De exacte uitdaginginvoer
Een startgrootboek, een bankafschrift en categorienregels.
Ga verder dan de demo.
Twee te kopiëren recepten bouwen voort op de bovenstaande demo: importeer een bank-CSV met voorgestelde categorieën door de agent, beantwoord daarna een saldovraag op basis van query-uitvoer. Elk paar combineert een agentprompt met CLI-equivalenten en verwachte resultaten.
Lees de agentreceptenTwijfelt u tussen tools? Beancount.io is een van de vijf die op dezelfde agent-workflowcriteria worden vergeleken, met gedateerde bronnen.
Lees de vergelijking van vijf toolsEen paar dingen voordat je begint.
Uw boeken blijven op uw machine
Elk commando hieronder werkt op plain-text .bean-bestanden in een door u gekozen map. Nieuwe grootboekbestanden zijn privé voor uw gebruiker, en elke toevoeging wordt gevalideerd tegen het volledige grootboek voordat het bestand wordt vervangen — op het standaard lokale CLI-pad is een onbekende rekening of een ongebalanceerde transactie een fout met begeleiding, en het bestand blijft onaangetast.
Heb ik een Beancount.io-account nodig?
Niet voor iets op deze pagina. Het installeren van bea, het maken van een lokaal grootboek, het registreren van aankopen en het controleren van saldi werken allemaal zonder account. U logt alleen in voor de optionele gehoste extras: bea ask, de MCP-server en gehoste grootboeken.
Stelt het installeren van de CLI mijn AI-agent in?
Nee. Installeren geeft u het bea-commando; uw agent blijft precies zoals het is. U plakt de bovenstaande taak in de shell-capabele agent die u al gebruikt, en het laden van agent-vaardigheden is een aparte stap op zich.
Verlaat mijn grootboek mijn machine?
Lokale commando's werken op lokale .bean-bestanden en doen geen netwerkaanroepen. Alleen de gehoste commando's — bea cloud en bea ask, waarvan de modelaanroepen via de gehoste AI-proxy lopen — communiceren met Beancount.io-services.
Wat gebeurt er als mijn agent een slechte invoer schrijft?
Op het standaard lokale CLI-pad wordt elke toevoeging gecontroleerd tegen het volledige grootboek voordat het bestand wordt vervangen. Een onbekende rekening of een ongebalanceerde transactie faalt met begeleiding en laat uw bestand onaangetast — laat de agent ook na elke handmatige bewerking bea check uitvoeren.
Wat heeft bea ask precies nodig?
Twee dingen naast deze pagina: de ask-afhankelijkheidsextra en gehoste referenties om mee in te loggen. De standaard bea-installatie laat de AI-afhankelijkheden opzettelijk weg totdat u erom vraagt.
Verbind gehoste tools wanneer je ze nodig hebt
Lokale CLI-opdrachten werken zonder Beancount.io-account. Gehoste AI-hulp en MCP-toegang zijn afzonderlijke, optionele verbindingen.
bea ask beantwoordt vragen over een lokaal grootboek via de gehoste AI-service. Het vereist de ask-extra — uv tool install 'beancount-io[ask]' — plus uw Beancount.io-referenties.
De MCP-server en gehoste grootboeken loggen eveneens in met uw Beancount.io-account om toegang te autoriseren. Begin lokaal; verbind hosting alleen als u dat wilt.
Agent-vaardigheden voor Beancount leven in de productrepository en worden afzonderlijk in uw agent geladen — het installeren van de CLI installeert of configureert deze niet.
Verken de MCP-verbindingJouw agent kan de boekhouding doen. Jij kunt het werk zien.
Begin met een lokaal grootboek en één verifieerbaar resultaat.