Для технических основателей, разработчиков и создателей агентов
Дайте своему ИИ-агенту бухгалтерскую книгу
Установите инструмент командной строки bea, затем вставьте одну задачу в поддерживающего команды shell ИИ-агента, которым вы уже пользуетесь. Через несколько минут он вернет проверенную локальную книгу — учетная запись Beancount.io не требуется.
Установите bea
Два официальных способа получить ту же команду. Выберите тот, который подходит для вашей машины, затем убедитесь, что он отвечает своей версией.
Через uv (везде, где есть Python 3.12 или новее)
uv tool install beancount-ioЧерез Homebrew (macOS или Linux)
brew install bex-co/tap/beabea --versionПример проверен с bea 0.1.0: дистрибутив Python называется beancount-io, а исполняемый файл, который он устанавливает, — bea.
Что вам нужно
Терминал, сетевое подключение и либо Homebrew, либо uv с Python 3.12 или новее. Для локального ведения книг учетная запись Beancount.io не требуется — она понадобится только для необязательного облачного шага ниже.
Ваши книги остаются на вашей машине
Каждая команда ниже работает с текстовыми файлами .bean в выбранном вами каталоге. Новые файлы книг являются приватными для вашего пользователя, и каждое добавление проверяется на соответствие всей книге перед заменой файла — по умолчанию, в локальном CLI, неизвестный счет или несбалансированная транзакция являются ошибкой с подсказкой, и файл остается нетронутым.
Первая задача вашего агента
Вставьте это в вашего агента. Он начинается с 1,000 USD на счете проверки, записывает покупку кофе на 12.50 USD, проверяет книгу и сообщает баланс с использованным запросом.
Промпт для задачи агента
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.Те же шаги в виде команд
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"Ожидаемый результат: Assets:Checking содержит 987.50 USD.
Прочитать краткое руководство по CLIНеобязательно: облачная помощь ИИ
Ничто из вышеперечисленного не требует учетной записи и не отправляет вашу книгу куда-либо. Два дополнительных пункта требуют этого, и оба отделены от установки CLI.
bea ask отвечает на вопросы о локальной книге через облачный ИИ-сервис. Для этого нужен дополнительный пакет ask — uv tool install 'beancount-io[ask]' — плюс ваши учетные данные Beancount.io.
MCP-сервер и облачные книги также входят в систему с вашей учетной записью Beancount.io для авторизации доступа. Начните локально; подключайте хостинг только если хотите.
Навыки агента для Beancount находятся в репозитории продукта и загружаются в вашего агента отдельно — установка CLI не устанавливает и не настраивает их.
Вопросы создателей агентов
Нужна ли мне учетная запись Beancount.io?
Нет, для ничего на этой странице. Установка bea, создание локальной книги, запись покупок и проверка балансов работают без учетной записи. Вы входите только для необязательных облачных дополнений: bea ask, MCP-сервер и облачные книги.
Настраивает ли установка CLI моего ИИ-агента?
Нет. Установка дает вам команду bea; ваш агент остается точно таким, как был. Вы вставляете задачу выше в поддерживающего shell агента, которым уже пользуетесь, а загрузка навыков агента — это отдельный шаг.
Покидает ли моя книга мою машину?
Локальные команды работают с локальными файлами .bean и не совершают сетевых вызовов. Только облачные команды — bea cloud и bea ask, чьи вызовы моделей проходят через облачный ИИ-прокси, — общаются с сервисами Beancount.io.
Что произойдет, если мой агент запишет неправильную запись?
По умолчанию, в локальном CLI, каждое добавление проверяется на соответствие всей книге перед заменой файла. Неизвестный счет или несбалансированная транзакция завершаются ошибкой с подсказкой и оставляют ваш файл нетронутым — попросите агента также запускать bea check после любого ручного редактирования.
Что именно нужно для bea ask?
Две вещи помимо этой страницы: дополнительный пакет ask и облачные учетные данные для входа. Стандартная установка bea намеренно не включает ИИ-зависимости, пока вы их не запросите.
Начните с кофе, оставайтесь ради книг
Одна установка, одна вставленная задача, один проверенный баланс — затем продолжайте с полным кратким руководством.