Beancount CLI кратък старт

Създайте местен главна книга и записвайте първата покупка с bea, командната линия от Beancount.io. Местно счетоводство не изисква акаунт Beancount.io.

Този преглед започва с 1 000 USD в чекова смета. След покупка на кафе за 12,50 USD ще проверите салдо от 987,50 USD.

1. Инсталирайте командата​

С Homebrew на macOS или Linux:

brew install bex-co/tap/bea
bea --version

Ако не използваете Homebrew, инсталирайте uv и използвайте uv tool install beancount-io. Python пакет изисква Python 3.12 или нове.

2. Създайте главна книга​

Изберете нова директория. Този пример създава main.bean вътре ~/my-books:

bea --no-input init ~/my-books --currency USD --date 2026-08-01 \
  --opening-balance "Assets:Checking 1000"
cd ~/my-books

Шаблонът отваря общи смета за чекови, спестяния, налични пари, кредитни карти, приходи и разходи. Откриваща салдо е компенсирано с Equity:OpeningBalances.

За вашите книги изберете най-ранната дата, кога искате записват. Вси шаблонни смета се отварят на та дата. Откриваща салдо трябва да описва сметата на та дата. Дълг по кредитна карта използва отрицателна сума.

init никога не презаписва съществувающа главна книга. Новви файли са приватни на POSIX системни: только собственик може ги четити и записвати. За споделяне с ваша местна потребителска группа, явно промените разрешения с chmod 640 main.bean.

За водителско определение вместо, изпълнете bea init ~/my-books в терминала. Визарда пита за валута, стартова дата на история, и чеков салдо.

3. Записвайте покупка​

bea add transaction --date 2026-08-02 --narration "Coffee" \
  --posting "Expenses:Dining 12.50" \
  --posting "Assets:Checking"

Разход използва валута на сметата. Beancount попълнява другоя позиция с -12.50 USD. Можете пропуснати --date за покупки, котори са направени денесь.

Каждо добавяние е проверено против пълната главна книга, преди файла се заменя. Непозната смета или небалнасирана транзакция произведе грешка с насочване.

4. Проверейте резултата​

bea check
bea list transaction --limit 10
bea report balance-sheet

Списока транзакции показва най-новви записи първи, с техните позиционни суми. Балансовий отчет показва 987.50 USD в чекова смета.

За проверете та сума директно:

bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"

Таблици от заявки запазва точностът резултата. За структурирани изход, постави глобалната флага --json преди командата:

bea --json list transaction --limit 10

5. Држите книги в добро състояние​

Изпълнете bea check след редактирание файла на ръка. Изпълнете bea format main.bean за подравняване колонки. Използвайте bea format main.bean --check когда сценарий трябва упасти, ако форматирание е изисквано.

За работа от друга директория, изберете коренови файла явно:

bea --file ~/my-books/main.bean check

Корен се избират с --file, потома BEA_FILE, потома main.bean в рабочая директория. Глобални опции стоят преди командата. Форматирание приема своя файл или директория аргумента.

Продължите със свои записи​

• Импортирайте банковски експорт с преглед и преглед на дубликати.
• Потърсите команди и опции за смета, салда, инвестиции, отчети и автоматизация.
• Организирайте главна книга преко файли. Използвайте --into за запис включен файл, проверяя против корена.
• Използвайте браузерни интерфейс ако предпочитаете форми на команди в терминала.

Проверейте за обновления с bea upgrade --check. Изпълнете bea upgrade за викане на менаджера пакети, който инсталира ваша копия. Използвайте bea --help или bea add transaction --help за преглед опции в ваша инсталирана версия.