Швидкий старт із 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 або новішої версії. Homebrew забезпечує ядро бухгалтерії під час встановлення. При установці через PyPI тримайте uv доступним: перша локальна команда завантажує кероване ядро, наступні команди використовують його офлайн. Окремо інсталювати Beancount не потрібно.

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"

Витрата використовує валюту рахунку — USD. 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 -i main.bean, щоб вирівняти його колонки на місці. Без -i форматований текст виводиться в stdout, а файл залишається незмінним. Використовуйте bea format main.bean --check, якщо скрипт має припинити роботу в разі необхідності форматування.

Щоб працювати з іншого каталогу, явно виберіть кореневий файл:

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

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

Продовжуйте з власними записами​

• Імпорт банківського експорту з попереднім переглядом та перевіркою дублікатів.
• Передайте зовнішньому агенту два завдання з бухгалтерії з копіюваними підказками та еквівалентами CLI.
• Порівняйте п’ять бухгалтерських інструментів для AI агентів за установкою, автентифікацією, охопленням, даними, переглядом, виводом і повтореннями, із датованими джерелами.
• Перегляньте команди та опції для рахунків, балансів, інвестицій, звітів і автоматизації.
• Організуйте головну книгу по файлах. Використовуйте --into для запису включеного файлу з перевіркою на відповідність кореню.
• Використовуйте інтерфейс браузера, якщо ви віддаєте перевагу формам замість команд терміналу.

Перевірте оновлення за допомогою bea upgrade --check. Запустіть bea upgrade, щоб викликати пакетний менеджер, який встановив вашу копію. Використовуйте bea --help або bea add transaction --help, щоб переглянути доступні опції у вашій встановленій версії.