Para fundadores técnicos, desarrolladores y creadores de agentes
Dale un libro mayor a tu agente de IA
Instala la herramienta de línea de comandos bea y luego pega una tarea en el agente de IA con acceso a shell que ya usas. En minutos, devuelve un libro mayor local verificado — sin necesidad de cuenta en Beancount.io.
Instalar bea
Dos formas publicadas de obtener el mismo comando. Elige la que se adapte a tu máquina y luego confirma que responde con su versión.
Con uv (en cualquier lugar con Python 3.12 o superior)
uv tool install beancount-ioCon Homebrew (macOS o Linux)
brew install bex-co/tap/beabea --versionEjemplo verificado con bea 0.1.0: la distribución de Python es beancount-io y el ejecutable que instala es bea.
Qué necesitas
Una terminal, conexión de red y Homebrew o uv con Python 3.12 o superior. La contabilidad local no requiere cuenta en Beancount.io; esa solo aparece en el paso opcional alojado a continuación.
Tus libros permanecen en tu máquina
Cada comando a continuación funciona con archivos .bean de texto plano en un directorio que elijas. Los nuevos archivos de libro mayor son privados para tu usuario, y cada adición se valida contra el libro mayor completo antes de reemplazar el archivo. En la ruta CLI local predeterminada, una cuenta desconocida o una transacción desbalanceada es un error con orientación, y el archivo no se toca.
La primera tarea de tu agente
Pega esto en tu agente. Comienza con 1,000 USD en cheques, registra un café de 12.50 USD, valida el libro mayor y reporta el saldo con la consulta utilizada.
Indicación de tarea para el agente
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.Los mismos pasos como comandos 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"Resultado esperado: Assets:Checking tiene 987.50 USD.
Leer el inicio rápido de la CLIOpcional: ayuda de IA alojada
Nada de lo anterior requiere cuenta ni envía tu libro mayor a ningún lugar. Dos extras opcionales sí lo hacen, y ambos son independientes de instalar la CLI.
bea ask responde preguntas sobre un libro mayor local a través del servicio de IA alojado. Necesita el extra ask — uv tool install 'beancount-io[ask]' — además de tus credenciales de Beancount.io.
El servidor MCP y los libros mayores alojados también inician sesión con tu cuenta de Beancount.io para autorizar el acceso. Comienza local; conecta el alojamiento solo si lo deseas.
Las habilidades de agente para Beancount viven en el repositorio del producto y se cargan en tu agente por separado: instalar la CLI no las instala ni configura.
Preguntas de los creadores de agentes
¿Necesito una cuenta en Beancount.io?
No para nada en esta página. Instalar bea, crear un libro mayor local, registrar compras y verificar saldos funcionan sin cuenta. Solo inicias sesión para los extras alojados opcionales: bea ask, el servidor MCP y los libros mayores alojados.
¿Instalar la CLI configura mi agente de IA?
No. Instalar te da el comando bea; tu agente permanece exactamente como está. Tú pegas la tarea anterior en el agente con acceso a shell que ya usas, y cargar habilidades de agente es un paso aparte.
¿Mi libro mayor sale de mi máquina?
Los comandos locales funcionan en archivos .bean locales y no hacen llamadas de red. Solo los comandos alojados — bea cloud y bea ask, cuyas llamadas de modelo pasan por el proxy de IA alojado — hablan con los servicios de Beancount.io.
¿Qué sucede si mi agente escribe una entrada incorrecta?
En la ruta CLI local predeterminada, cada adición se verifica contra el libro mayor completo antes de reemplazar el archivo. Una cuenta desconocida o una transacción desbalanceada falla con orientación y deja tu archivo sin tocar. Haz que el agente ejecute bea check también después de cualquier edición manual.
¿Qué necesita exactamente bea ask?
Dos cosas además de esta página: el extra de dependencia ask y credenciales alojadas para iniciar sesión. La instalación predeterminada de bea omite intencionalmente las dependencias de IA hasta que las pidas.
Comienza con café, quédate por los libros
Una instalación, una tarea pegada, un saldo verificado — luego continúa con el inicio rápido completo.