Voor technische oprichters, ontwikkelaars en agentbouwers
Geef uw AI-agent een grootboek
Installeer het bea-opdrachtregelprogramma en plak vervolgens één taak in de shell-capabele AI-agent die u al gebruikt. Enkele minuten later levert het een gevalideerd lokaal grootboek op — geen Beancount.io-account vereist.
Installeer bea
Twee gepubliceerde manieren om dezelfde opdracht te krijgen. Kies degene die bij uw machine past en bevestig vervolgens dat deze antwoordt met de versie.
Met uv (overal met Python 3.12 of nieuwer)
uv tool install beancount-ioMet Homebrew (macOS of Linux)
brew install bex-co/tap/beabea --versionVoorbeeld geverifieerd met bea 0.1.0: de Python-distributie is beancount-io en het uitvoerbare bestand dat het installeert is bea.
Wat u nodig hebt
Een terminal, een netwerkverbinding en ofwel Homebrew of 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.
Uw boeken blijven op uw machine
Elke opdracht hieronder werkt op platte-tekst .bean-bestanden in een map naar keuze. 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 account of een niet-sluitende transactie een fout met begeleiding en wordt het bestand onaangeraakt gelaten.
De eerste taak van uw agent
Plak dit in uw agent. Het begint met 1,000 USD op een betaalrekening, registreert een koffie van 12.50 USD, valideert het grootboek en rapporteert het saldo met de gebruikte query.
Taakprompt voor agent
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.Dezelfde stappen als eenvoudige opdrachten
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"Verwacht resultaat: Assets:Checking bevat 987.50 USD.
Lees de CLI-snelstartgidsOptioneel: gehoste AI-hulp
Niets hierboven vereist een account of stuurt uw grootboek ergens naartoe. Twee optionele extra's doen dat wel, en beide zijn gescheiden van het installeren van de CLI.
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 melden zich eveneens aan met uw Beancount.io-account om toegang te autoriseren. Begin lokaal; verbind hosting alleen als u dat wilt.
Agentvaardigheden voor Beancount leven in de productrepository en laden afzonderlijk in uw agent — het installeren van de CLI installeert of configureert ze niet.
Vragen die agentbouwers stellen
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 meldt zich alleen aan voor de optionele gehoste extra's: bea ask, de MCP-server en gehoste grootboeken.
Configureert het installeren van de CLI mijn AI-agent?
Nee. Installeren geeft u de bea-opdracht; uw agent blijft precies zoals hij is. U plakt de bovenstaande taak in de shell-capabele agent die u al gebruikt, en het laden van agentvaardigheden is een aparte stap op zich.
Verlaat mijn grootboek mijn machine?
Lokale opdrachten werken op lokale .bean-bestanden en doen geen netwerkaanroepen. Alleen de gehoste opdrachten — 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 account of een niet-sluitende transactie mislukt met begeleiding en laat uw bestand onaangeraakt — 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 aan te melden. De standaard bea-installatie laat de AI-afhankelijkheden opzettelijk weg totdat u erom vraagt.
Begin met koffie, blijf voor de boeken
Eén installatie, één geplakte taak, één geverifieerd saldo — ga dan verder met de volledige snelstart.