Pour les fondateurs techniques, développeurs et créateurs d'agents
Donnez un grand livre à votre agent IA
Installez l'outil en ligne de commande bea, puis collez une tâche dans l'agent IA compatible shell que vous utilisez déjà. Quelques minutes plus tard, il vous remet un grand livre local validé — aucun compte Beancount.io requis.
Installer bea
Deux méthodes publiées pour obtenir la même commande. Choisissez celle qui correspond à votre machine, puis confirmez qu'elle répond avec sa version.
Avec uv (partout où Python 3.12 ou plus récent est disponible)
uv tool install beancount-ioAvec Homebrew (macOS ou Linux)
brew install bex-co/tap/beabea --versionExemple vérifié avec bea 0.1.0 : la distribution Python est beancount-io et l'exécutable qu'elle installe est bea.
Ce dont vous avez besoin
Un terminal, une connexion réseau, et Homebrew ou uv avec Python 3.12 ou plus récent. La tenue de livres locale ne nécessite pas de compte Beancount.io — celui-ci n'entre en jeu que pour l'étape hébergée facultative ci-dessous.
Vos livres restent sur votre machine
Chaque commande ci-dessous fonctionne sur des fichiers .bean en texte brut dans un répertoire de votre choix. Les nouveaux fichiers de grand livre sont privés à votre utilisateur, et chaque ajout est validé par rapport à l'ensemble du grand livre avant que le fichier ne soit remplacé — sur le chemin CLI local par défaut, un compte inconnu ou une transaction non équilibrée est une erreur avec des conseils, et le fichier reste intact.
La première tâche de votre agent
Collez ceci dans votre agent. Il commence avec 1,000 USD en compte courant, enregistre un café à 12.50 USD, valide le grand livre et rapporte le solde avec la requête utilisée.
Invite de tâche d'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.Les mêmes étapes en commandes simples
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"Résultat attendu : Assets:Checking contient 987.50 USD.
Lire le guide de démarrage rapide CLIFacultatif : aide IA hébergée
Rien de ce qui précède ne nécessite un compte ni n'envoie votre grand livre où que ce soit. Deux extras facultatifs le font, et ils sont tous deux distincts de l'installation du CLI.
bea ask répond aux questions sur un grand livre local via le service IA hébergé. Il nécessite l'extra ask — uv tool install 'beancount-io[ask]' — ainsi que vos identifiants Beancount.io.
Le serveur MCP et les livres hébergés se connectent également avec votre compte Beancount.io pour autoriser l'accès. Commencez en local ; connectez l'hébergement seulement si vous le souhaitez.
Les compétences d'agent pour Beancount vivent dans le dépôt de produit et se chargent dans votre agent séparément — installer le CLI ne les installe ni ne les configure.
Questions que se posent les créateurs d'agents
Ai-je besoin d'un compte Beancount.io ?
Non, pas pour tout ce qui se trouve sur cette page. Installer bea, créer un grand livre local, enregistrer des achats et vérifier les soldes fonctionnent sans compte. Vous vous connectez uniquement pour les extras hébergés facultatifs : bea ask, le serveur MCP et les livres hébergés.
L'installation du CLI configure-t-elle mon agent IA ?
Non. L'installation vous donne la commande bea ; votre agent reste exactement tel qu'il est. Vous collez la tâche ci-dessus dans l'agent compatible shell que vous utilisez déjà, et le chargement des compétences d'agent est une étape distincte en soi.
Mon grand livre quitte-t-il ma machine ?
Les commandes locales fonctionnent sur des fichiers .bean locaux et n'effectuent aucun appel réseau. Seules les commandes hébergées — bea cloud et bea ask, dont les appels de modèles passent par le proxy IA hébergé — communiquent avec les services Beancount.io.
Que se passe-t-il si mon agent écrit une mauvaise entrée ?
Sur le chemin CLI local par défaut, chaque ajout est vérifié par rapport à l'ensemble du grand livre avant que le fichier ne soit remplacé. Un compte inconnu ou une transaction non équilibrée échoue avec des conseils et laisse votre fichier intact — faites également exécuter bea check par l'agent après toute modification manuelle.
De quoi exactement bea ask a-t-il besoin ?
Deux choses au-delà de cette page : l'extra de dépendance ask et des identifiants hébergés pour se connecter. L'installation par défaut de bea omet intentionnellement les dépendances IA jusqu'à ce que vous les demandiez.
Commencez par un café, restez pour les livres
Une installation, une tâche collée, un solde vérifié — puis continuez avec le guide de démarrage rapide complet.