Dale a tu agente de IA un libro mayor
Convierte una tarea en libros que puedas inspeccionar. Dale a tu agente con capacidad de shell la CLI de bea para registrar transacciones, verificar su trabajo y devolver un saldo respaldado por texto plano.
Instalar bea
Elige tu instalador y luego comprueba la versión. Los libros locales no necesitan una cuenta de Beancount.io.
uv · Python 3.12+
uv tool install beancount-ioHomebrew · macOS o Linux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDTexto plano. Tuyo para conservar.
Archivos .bean locales que puedes leer, comparar y versionar con Git.
Una comprobación antes de cada cambio.
Las adiciones por defecto de la CLI deben validarse antes de reemplazar tu libro.
Trae el agente que uses.
Un agente con capacidad de shell, una tarea y comandos que puedes inspeccionar.
Lo que necesitas
Una terminal, una conexión de red y Homebrew o uv con Python 3.12 o posterior. La contabilidad local no requiere una cuenta de Beancount.io; eso solo aparece en el paso opcional alojado a continuación.
bea --versionEjemplo verificado con bea 0.1.0: la distribución de Python es beancount-io y el ejecutable que instala es bea.
Una pequeña tarea. Un conjunto real de libros.
Comienza con 1,000 USD. Registra un café de 12.50 USD. Pide a tu agente que verifique el libro y muestre la consulta detrás de su respuesta.
Indicación de tarea del agente
Tienes acceso al shell y la CLI `bea` instalada. Primero, ejecuta `bea --help` y lee lo que ofrece. Luego, en un NUEVO directorio de demostración vacío (no toques ningún libro mayor existente): 1) crea un libro mayor en USD abriendo Assets:Checking con 1000 el 2026-08-01; 2) agrega una compra de 12.50 USD narrativa "Coffee" a Expenses:Dining el 2026-08-02; 3) ejecuta `bea check`; 4) reporta el saldo de Assets:Checking junto con la consulta BQL exacta que usaste. Resultado esperado: 987.50 USD.- Crea un libro de demostración nuevo
- Registra la compra del café
- Verifica los libros y consulta el saldo
Resultado esperado: Assets:Checking tiene 987.50 USD.
Ejecútalo tú mismo, comando por comando
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"Pon a prueba a tu agente.
Tres transacciones bancarias. Una ejecución de agente registrada. Descarga las mismas entradas, reproduce el resultado e inspecciona lo que sucedió en el camino.
Leer la ejecución grabadaDatos sintéticos, verificados con bea 0.1.0. Una ejecución observada; el registro completo incluye fallos y limitaciones.
Las entradas exactas del desafío
Un libro inicial, un extracto bancario y reglas de categorización.
Llévalo más allá de la demostración.
Dos recetas copiables se basan en la demo anterior: importa un CSV bancario con categorías propuestas por el agente y luego responde una pregunta de saldo a partir de la salida de la consulta. Cada una combina una indicación de agente con equivalentes CLI y resultados esperados.
Leer las recetas del agente¿Eligiendo entre herramientas? Beancount.io es uno de los cinco comparados según los mismos criterios de flujo de trabajo de agentes, con fuentes fechadas.
Leer la comparación de las cinco herramientasAlgunas cosas antes de empezar.
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 no balanceada es un error con orientación, y el archivo se deja intacto.
¿Necesito una cuenta de Beancount.io?
No para nada en esta página. Instalar bea, crear un libro mayor local, registrar compras y verificar saldos funciona 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á. Pegas la tarea anterior en el agente con acceso a shell que ya usas, y cargar las habilidades del agente es un paso separado.
¿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 no balanceada falla con orientación y deja tu archivo intacto: haz que el agente ejecute bea check después de cualquier edición manual también.
¿Qué necesita exactamente bea ask?
Dos cosas más allá de esta página: el extra de dependencia ask y las credenciales alojadas para iniciar sesión. La instalación predeterminada de bea omite intencionalmente las dependencias de IA hasta que las solicites.
Conecta herramientas alojadas cuando las necesites
Los comandos CLI locales funcionan sin una cuenta de Beancount.io. La ayuda de IA alojada y el acceso MCP son conexiones separadas y opcionales.
bea ask responde preguntas sobre un libro mayor local mediante el servicio de IA alojado. Necesita el extra ask: uv tool install 'beancount-io[ask]' — más 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 las configura.
Explora la conexión MCPTu agente puede hacer la contabilidad. Tú puedes ver el trabajo.
Comienza con un libro local y un resultado verificable.