Para fundadores técnicos, desenvolvedores e construtores de agentes
Dê ao seu agente de IA um livro de contabilidade
Instale a ferramenta de linha de comando bea, depois cole uma tarefa no agente de IA com capacidade de shell que você já usa. Minutos depois, ele devolve um livro de contabilidade local validado — não é necessária uma conta Beancount.io.
Instalar bea
Duas formas publicadas de obter o mesmo comando. Escolha a que se adapta à sua máquina e confirme que ele responde com sua versão.
Com uv (em qualquer lugar com Python 3.12 ou mais recente)
uv tool install beancount-ioCom Homebrew (macOS ou Linux)
brew install bex-co/tap/beabea --versionExemplo verificado com bea 0.1.0: a distribuição Python é beancount-io e o executável que instala é bea.
O que você precisa
Um terminal, uma conexão de rede e Homebrew ou uv com Python 3.12 ou mais recente. A contabilidade local não requer uma conta Beancount.io — ela só entra em jogo para a etapa hospedada opcional abaixo.
Seus livros permanecem na sua máquina
Todos os comandos abaixo funcionam em arquivos .bean de texto simples em um diretório que você escolhe. Novos arquivos de livro são privados do seu usuário, e cada adição é validada contra o livro completo antes de o arquivo ser substituído — no caminho CLI local padrão, uma conta desconhecida ou uma transação desequilibrada é um erro com orientação, e o arquivo fica intacto.
Primeira tarefa do seu agente
Cole isto no seu agente. Começa com 1,000 USD em conta corrente, registra um café de 12.50 USD, valida o livro e reporta o saldo com a consulta usada.
Prompt da tarefa do 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.Os mesmos passos em 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 tem 987.50 USD.
Leia o guia rápido da CLIOpcional: ajuda de IA hospedada
Nada acima precisa de conta nem envia seu livro para lugar nenhum. Dois extras opcionais fazem isso, e ambos são separados da instalação do CLI.
O bea ask responde perguntas sobre um livro local através do serviço de IA hospedado. Precisa do extra ask — uv tool install 'beancount-io[ask]' — além das suas credenciais Beancount.io.
O servidor MCP e os livros hospedados também iniciam sessão com sua conta Beancount.io para autorizar o acesso. Comece pelo local; conecte a hospedagem só se quiser.
As skills de agente para o Beancount ficam no repositório do produto e são carregadas no seu agente separadamente — instalar o CLI não as instala nem configura.
Perguntas que criadores de agentes fazem
Preciso de uma conta Beancount.io?
Não para nada nesta página. Instalar o bea, criar um livro local, registrar compras e verificar saldos — tudo funciona sem conta. Você só entra com login para os extras hospedados opcionais: bea ask, o servidor MCP e os livros hospedados.
Instalar o CLI configura meu agente de IA?
Não. Instalar lhe dá o comando bea; seu agente continua exatamente como está. Você cola a tarefa acima no agente com capacidade de shell que já usa, e carregar as skills de agente é um passo separado.
Meu livro sai da minha máquina?
Os comandos locais trabalham com arquivos .bean locais e não fazem chamadas de rede. Só os comandos hospedados — bea cloud e bea ask, cujas chamadas de modelo passam pelo proxy de IA hospedado — falam com os serviços Beancount.io.
O que acontece se meu agente escrever um lançamento errado?
No caminho CLI local padrão, cada adição é verificada contra o livro completo antes de o arquivo ser substituído. Uma conta desconhecida ou uma transação desequilibrada falha com orientação e deixa seu arquivo intacto — peça ao agente para rodar bea check depois de qualquer edição manual também.
De que exatamente o bea ask precisa?
Duas coisas além desta página: o extra de dependência ask e credenciais hospedadas para entrar com login. A instalação padrão do bea omite intencionalmente as dependências de IA até que você as peça.
Comece com um café, fique pelos livros
Uma instalação, uma tarefa colada, um saldo verificado — depois continue com o guia rápido completo.