Für technische Gründer, Entwickler und Agentenbauer
Geben Sie Ihrem KI-Agenten ein Hauptbuch
Installieren Sie das bea-Befehlszeilentool und fügen Sie dann eine Aufgabe in den Shell-fähigen KI-Agenten ein, den Sie bereits verwenden. Wenige Minuten später erhalten Sie ein validiertes lokales Hauptbuch zurück – kein Beancount.io-Konto erforderlich.
bea installieren
Zwei veröffentlichte Wege, um denselben Befehl zu erhalten. Wählen Sie den, der zu Ihrem Rechner passt, und bestätigen Sie dann, dass er mit seiner Version antwortet.
Mit uv (überall mit Python 3.12 oder neuer)
uv tool install beancount-ioMit Homebrew (macOS oder Linux)
brew install bex-co/tap/beabea --versionBeispiel verifiziert mit bea 0.1.0: Die Python-Distribution ist beancount-io und die ausführbare Datei, die sie installiert, ist bea.
Was Sie benötigen
Ein Terminal, eine Netzwerkverbindung und entweder Homebrew oder uv mit Python 3.12 oder neuer. Für lokale Buchhaltung ist kein Beancount.io-Konto erforderlich – das ist nur für den optionalen gehosteten Schritt unten relevant.
Ihre Bücher bleiben auf Ihrem Rechner
Jeder Befehl unten funktioniert mit Klartext-.bean-Dateien in einem von Ihnen gewählten Verzeichnis. Neue Hauptbuchdateien sind privat für Ihren Benutzer, und jede Ergänzung wird gegen das vollständige Hauptbuch validiert, bevor die Datei ersetzt wird – auf dem Standard-Lokalbefehlsweg ist ein unbekanntes Konto oder eine unausgeglichene Transaktion ein Fehler mit Hinweisen, und die Datei bleibt unberührt.
Die erste Aufgabe Ihres Agenten
Fügen Sie dies in Ihren Agenten ein. Es beginnt mit 1,000 USD auf dem Girokonto, erfasst einen Kaffee für 12.50 USD, validiert das Hauptbuch und meldet den Saldo mit der verwendeten Abfrage zurück.
Agentenaufgaben-Prompt
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.Die gleichen Schritte als einfache Befehle
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"Erwartetes Ergebnis: Assets:Checking enthält 987.50 USD.
CLI-Schnellstart lesenOptional: gehostete KI-Hilfe
Nichts oben erfordert ein Konto oder sendet Ihr Hauptbuch irgendwohin. Zwei optionale Extras tun dies, und beide sind getrennt von der Installation der CLI.
bea ask beantwortet Fragen zu einem lokalen Hauptbuch über den gehosteten KI-Dienst. Es benötigt das ask-Extra – uv tool install 'beancount-io[ask]' – sowie Ihre Beancount.io-Anmeldedaten.
Der MCP-Server und gehostete Hauptbücher melden sich ebenfalls mit Ihrem Beancount.io-Konto an, um den Zugriff zu autorisieren. Starten Sie lokal; verbinden Sie Hosting nur, wenn Sie es möchten.
Agenten-Fähigkeiten für Beancount leben im Produkt-Repository und werden separat in Ihren Agenten geladen – die Installation der CLI installiert oder konfiguriert sie nicht.
Fragen, die Agentenbauer stellen
Brauche ich ein Beancount.io-Konto?
Nicht für irgendetwas auf dieser Seite. Das Installieren von bea, das Erstellen eines lokalen Hauptbuchs, das Erfassen von Käufen und das Überprüfen von Salden funktionieren alle ohne Konto. Sie melden sich nur für die optionalen gehosteten Extras an: bea ask, den MCP-Server und gehostete Hauptbücher.
Richtet die Installation der CLI meinen KI-Agenten ein?
Nein. Die Installation gibt Ihnen den bea-Befehl; Ihr Agent bleibt genau so, wie er ist. Sie fügen die obige Aufgabe in den Shell-fähigen Agenten ein, den Sie bereits verwenden, und das Laden von Agenten-Fähigkeiten ist ein separater Schritt.
Verlässt mein Hauptbuch meinen Rechner?
Lokale Befehle arbeiten mit lokalen .bean-Dateien und tätigen keine Netzwerkaufrufe. Nur die gehosteten Befehle – bea cloud und bea ask, deren Modellaufrufe über den gehosteten KI-Proxy laufen – sprechen mit den Diensten von Beancount.io.
Was passiert, wenn mein Agent einen fehlerhaften Eintrag schreibt?
Auf dem Standard-Lokalbefehlsweg wird jede Ergänzung gegen das vollständige Hauptbuch geprüft, bevor die Datei ersetzt wird. Ein unbekanntes Konto oder eine unausgeglichene Transaktion schlägt mit Hinweisen fehl und lässt Ihre Datei unberührt – lassen Sie den Agenten auch nach jeder manuellen Bearbeitung bea check ausführen.
Was genau braucht bea ask?
Zwei Dinge über diese Seite hinaus: das ask-Abhängigkeits-Extra und gehostete Anmeldedaten für die Anmeldung. Die Standardinstallation von bea lässt die KI-Abhängigkeiten absichtlich aus, bis Sie sie anfordern.
Beginnen Sie mit Kaffee, bleiben Sie für die Bücher
Eine Installation, eine eingefügte Aufgabe, ein verifizierter Saldo – dann weiter mit dem vollständigen Schnellstart.