Для технічних засновників, розробників і творців агентів
Дайте своєму AI-агенту бухгалтерську книгу
Встановіть інструмент командного рядка bea, а потім вставте одне завдання у сумісний із shell AI-агента, яким ви вже користуєтеся. Через кілька хвилин він поверне перевірену локальну книгу — без облікового запису 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Додатково: хостингова AI-допомога
Ніщо з вищезазначеного не потребує облікового запису і не надсилає вашу книгу кудись. Два додаткові параметри потребують, і обидва є окремими від встановлення CLI.
bea ask відповідає на запитання про локальну книгу через хостингову службу AI. Для цього потрібен додатковий пакет ask — uv tool install 'beancount-io[ask]' — плюс ваші облікові дані Beancount.io.
Сервер MCP і хостингові книги також входять за допомогою облікового запису Beancount.io, щоб авторизувати доступ. Почніть локально; підключайте хостинг, лише якщо хочете.
Навички агента для Beancount знаходяться в репозиторії продукту і завантажуються у ваш агент окремо — встановлення CLI не встановлює та не налаштовує їх.
Питання, які ставлять творці агентів
Чи потрібен мені обліковий запис Beancount.io?
Ні для чого на цій сторінці. Встановлення bea, створення локальної книги, запис покупок і перевірка балансів працюють без облікового запису. Ви входите лише для додаткових хостингових функцій: bea ask, сервера MCP і хостингових книг.
Чи налаштовує встановлення CLI мого AI-агента?
Ні. Встановлення дає вам команду bea; ваш агент залишається точно таким, як є. Ви вставляєте завдання вище у сумісного з shell агента, яким ви вже користуєтеся, а завантаження навичок агента є окремим кроком.
Чи залишає моя книга мою машину?
Локальні команди працюють з локальними файлами .bean і не виконують мережевих викликів. Лише хостингові команди — bea cloud і bea ask, чиї виклики моделі проходять через хостинговий AI-проксі, — спілкуються зі службами Beancount.io.
Що станеться, якщо мій агент напише поганий запис?
За замовчуванням для локального CLI кожне доповнення перевіряється проти повної книги перед заміною файла. Невідомий рахунок або незбалансована транзакція завершується помилкою з поясненням і залишає ваш файл недоторканим — також попросіть агента виконати bea check після будь-якого ручного редагування.
Що саме потрібно для bea ask?
Дві речі, крім цієї сторінки: додатковий пакет залежності ask і хостингові облікові дані для входу. Стандартне встановлення bea навмисно пропускає залежності AI, поки ви їх не попросите.
Почніть з кави, залишайтеся для книг
Одне встановлення, одне вставлене завдання, один перевірений баланс — а потім продовжуйте з повним швидким стартом.