Ви вже довіряєте вашому AI-агенту ваш код, ваш термінал і ваші найскладніші сеанси налагодження. Тепер довірте йому ваші книги — кожен запис, який він створює, проходить через попередній перегляд, який ви затверджуєте, та перевірку, яка контролює математику. Інструмент командного рядка bea встановлюється за допомогою двох команд, працює з текстовими файлами бухгалтерської книги на вашому власному компʼютері та не потребує облікового запису для локального ведення бухгалтерії.
Встановлення за дві команди
Існують два опубліковані способи отримати ту саму команду. Виберіть той, який підходить для вашої машини, а потім переконайтеся, що вона відповідає своєю версією:
$ uv tool install beancount-io
$ brew install bex-co/tap/bea
$ bea --version
bea 0.1.0Python-дистрибутив називається beancount-io, а виконуваний файл, який він встановлює, — bea, наразі версії 0.1.0. Шлях через uv працює будь-де з Python 3.12 або новішим; шлях через Homebrew охоплює macOS і Linux. Повне покрокове керівництво знаходиться на сторінці встановлення, з тими самими кроками в короткому посібнику з CLI.
Перше завдання вашого агента займає хвилини
Вам не потрібен новий агент, плагін чи міграція платформи. Вставте це в сумісного з терміналом AI-агента, яким ви вже користуєтеся, у свіжій порожній демонстраційній директорії:
Ви маєте доступ до терміналу та встановлений CLI-інструмент
bea. Спочатку виконайтеbea --helpі прочитайте, що він пропонує. Потім у НОВІЙ порожній демонстраційній директорії (не чіпайте жодну наявну бухгалтерську книгу): 1) створіть книгу в USD, відкривши Assets:Checking на 1000 станом на 2026-08-01; 2) додайте покупку на 12,50 USD із описом "Coffee" до Expenses:Dining станом на 2026-08-02; 3) виконайтеbea check; 4) повідомте баланс Assets:Checking разом із точним запитом BQL, який ви використали. Очікуваний результат: 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 — 1000 мінус 12,50, перевірено за допомогою check і повідомлено запитом, який це обчислив. Коли ваш агент передасть вам це число, він виконав свій перший замкнутий цикл: створення, перевірка, звіт. Посібник для агентів розвиває той самий цикл із двома повнішими рецептами — імпорт банківського CSV із попереднім переглядом і відповідь на питання про баланс на основі результатів запиту.
Що вам потрібно та кому це підходить
Термінал, мережеве зʼєднання та або Homebrew, або uv із Python 3.12 або новішим. Локальні команди імпорту, запиту, звіту та перевірки не потребують облікового запису Beancount.io, а ваші файли бухгалтерської книги залишаються в директорії, яку ви обираєте, у вигляді звичайного тексту, який можна порівнювати, резервувати та контролювати версії.
Це підходить технічним засновникам, які ведуть власну бухгалтерію стартапу, незалежним розробникам, які вже живуть у терміналі, та творцям агентів, які шукають бухгалтерську книгу, до якої AI може вносити зміни без мовчазних записів. Якщо ваші книги вже живуть у хмарному продукті, чесна відповідь інша — дивіться розділ порівняння нижче.
Хмарний шлях є додатковим і окремим
Нічого з перерахованого вище не потребує облікового запису та не надсилає вашу книгу куди-небудь. Дві додаткові функції потребують цього, і обидві навмисно відокремлені від встановлення CLI:
bea askвідповідає на запитання про локальну книгу через хмарний AI-сервіс. Він потребує додаткового пакета ask —uv tool install 'beancount-io[ask]'— а також ваших облікових даних Beancount.io. Стандартне встановлення опускає залежності AI, доки ви їх не запросите.- MCP-сервер і хмарні книги також входять за допомогою вашого облікового запису Beancount.io для авторизації доступу. Навички агентів для Beancount знаходяться в репозиторії продукту та завантажуються у ваш агент окремо — встановлення CLI не встановлює та не налаштовує їх.
Почніть із локального; підключайте хостинг лише якщо хочете.
Доказ: один агент, три рядки, перевірені книги
Заява про запуск настільки ж надійна, наскільки відтворювана. Тому разом із CLI постачається синтетичне завдання з трьох рядків із відповіддю, отриманою з арифметики до будь-якого звіту: книги відкриваються 2026-09-01 із 1000 USD на рахунку checking, у виписці є клієнтський платіж 2000,00 USD, рахунок за хостинг −29,00 USD і візит у кафе −12,50 USD, а очікувані відповіді — 2958,50 USD на checking (1000 + 2000 − 29 − 12,50) і 1958,50 USD вересневого прибутку (2000 − 29 − 12,50).
Верифікатор із встановленим CLI виконує весь цикл у свіжій тимчасовій директорії: попередній перегляд повідомляє про 3 готові записи та нічого не записує, перше застосування записує 3 записи, повторний ідентичний імпорт записує 0 із збереженими байтами книги, незбалансований запис (−5 checking проти +4 dining) завершується з кодом 1 із збереженими байтами, а check повертає валідність. Точні вхідні дані доступні для завантаження як main.bean, statement.csv та rules.toml.
Потім один справжній агент виконав те саме завдання: клієнт muse 1.1.1 (Muse Code) із моделлю muse-spark-1.3-contributor, без графічного інтерфейсу, 22 виклики інструментів, код виходу 0, без втручань людини — і, що важливо, без наданого rules.toml, тому агент самостійно вивів свою категоризацію. Він переглянув 3 готові записи, застосував 3 записи, виконав чисту перевірку та повідомив про 2958,50 USD на checking і 1958,50 USD вересневого прибутку, обидва значення пізніше повторно перевірені проти незалежних очікуваних значень. Повний запис — фактичний запит, кожен виклик інструменту та одна реальна помилка, яку він самостійно діагностував (блокування кешу в пісочниці, виправлене вказівкою XDG_CACHE_HOME у робочу директорію) — опубліковано як записаний запуск, разом із сирим транскриптом.
Термінальна сесія нижче — це детерміноване відтворення робочого шляху цього запуску, відтворене з канонічних завантажень за допомогою demo-replay.sh — вона повторює команди, тому вбудовує правила категоризації для детермінованості, а не виводить їх заново. Захоплений вивід у demo-replay.txt несе ту саму інформацію, що й перегляд:
$ bea --version
bea 0.1.0
$ bea import (preview)
csv → Assets:Checking: 3 ready, 0 exact duplicates, 0 possible duplicates
$ bea import --apply
Wrote 3 entries to $WORK/books/main.bean.
$ bea check
$WORK/books/main.bean: no errors
$ bea balance Assets:Checking
Checking 2,958.50 USD
$ bea report income-statement -t 2026-09
Net Profit: 1,958.50 USD
checking: 2958.50 USD (expected)
profit: 1958.50 USD (expected)
REPLAY OK: preview 3/0, applied 3, check clean, 2958.50 / 1958.50 USD.Із цими доказами повʼязані дві чесні обмеження. Це перевірка виводу CLI одного запуску одного клієнта на синтетичних даних — не бенчмарк моделі, і вона нічого не стверджує про інші клієнти чи неконтрольоване виробниче використання. І успішний check доводить, що книга збалансована, але ніколи не те, що агент правильно обрав рахунок для кафе: судження про категорію — за агентом, структурна перевірка — за bea. Іграшка з трьох рядків тестує цикл, а не судження.
Вибір між інструментами
Якщо ви обираєте бухгалтерську книгу для робочих процесів агентів, а не зупинилися саме на цьому, прочитайте порівняння пʼяти інструментів: Beancount.io, Xero, QuickBooks Online, Puzzle та hledger оцінені за тими самими сімома критеріями робочих процесів агентів — встановлення, автентифікація, обсяг читання/запису, локальні проти хмарних даних, попередній перегляд і перевірка, структурований вивід і поведінка повторного імпорту — з датованими офіційними джерелами, перевіреними 2026-09-10. Beancount.io — єдиний інструмент там із спостережуваним наскрізним запуском за ним; сторінка це говорить, називає свого видавця і позначає, що вона не тестувала.
Куди рухатися далі
- Сторінка встановлення — дві команди, перше завдання та завантаження завдання в одному місці.
- Короткий посібник із CLI — встановлення плюс опрацьований приклад із 987,50 USD.
- Посібник для агентів — два рецепти: імпорт CSV із попереднім переглядом і питання про баланс із результатів запиту.
- Записаний запуск — повна історія доказів із методологією, помилками та обмеженнями.
- Порівняння пʼяти інструментів — який інструмент підходить для якого робочого процесу агента.
Спростіть ваше фінансове управління
Найшвидший спосіб оцінити все це — демонстрація вище: встановіть bea, вставте завдання в агента, яким ви вже користуєтеся, і перевірте 987,50 USD самостійно. Beancount.io надає бухгалтерію у вигляді звичайного тексту, яка зберігає відтворюваність кожного балансу та можливість перегляду кожної зміни — без чорних скриньок, без привʼязки до постачальника. Дайте вашому агенту його першу бухгалтерську книгу і подивіться, що він поверне.
