За технически основатели, разработчици и създатели на агенти
Дайте на вашия AI агент сметководна книга
Инсталирайте командния инструмент bea, след което поставете една задача в 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; вашият агент остава точно както е. Вие поставяте задачата по-горе в агента с шел достъп, който вече използвате, а зареждането на умения за агенти е отделна стъпка.
Напуска ли книгата ми моята машина?
Локалните команди работят с локални .bean файлове и не правят мрежови заявки. Само хостинг командите — bea cloud и bea ask, чиито моделни повиквания преминават през хостинг AI проксито — говорят с услугите на Beancount.io.
Какво става, ако агентът ми напише грешен запис?
По подразбиране на локалния CLI път, всяко допълнение се проверява спрямо пълната книга преди файлът да бъде заменен. Неизвестна сметка или небалансирана транзакция се проваля с насоки и оставя файла ви непокътнат — накарайте агента да изпълни bea check и след ръчна редакция.
Какво точно изисква bea ask?
Две неща извън тази страница: допълнителния пакет ask и хостинг идентификационни данни за влизане. Инсталацията по подразбиране на bea умишлено пропуска AI зависимостите, докато не ги поискате.
Започнете с кафе, останете за книгите
Една инсталация, една поставена задача, едно проверено салдо — след това продължете с пълния бърз старт.