# Awesome Beancount

Ретельно підібраний посібник з екосистеми Beancount. Beancount — це потужна система бухгалтерського обліку з відкритим вихідним кодом, яка використовує простий текстовий формат для управління вашими фінансами з дотриманням принципів подвійного запису. Ця сторінка об'єднує списки, підготовлені спільнотою, та огляди екосистеми в один комплексний ресурс.

## Чому бухгалтерський облік у простому текстовому форматі?

Бухгалтерський облік у простому тексті (PTA) — це методологія управління фінансами за допомогою простих текстових файлів і потужних інструментів командного рядка. Цей підхід дає вам повне володіння вашими даними, гарантує їх довговічність і пропонує неперевершену гнучкість для автоматизації та аналізу.

- **Офіційний хаб PTA:** [Plain Text Accounting](https://plaintextaccounting.org/)
- **Лагідний вступ:** [Бухгалтерський облік для простих розумів за допомогою PTA](https://dustri.org/b/accounting-for-the-simple-minds-with-plain-text-accounting.html)
- **Від вебдодатків до CLI:** [Бухгалтерський облік у командному рядку: Від mint.com до Ledger](https://muehe.org/posts/command-line-accounting/)

***

## Екосистема Beancount

Екосистема Beancount — це сукупність інструментів, плагінів та ресурсів, побудованих навколо базового рушія. Кожен компонент відіграє певну роль у створенні повного робочого процесу управління фінансами.

### 1. Основний рушій та офіційні ресурси

Це основоположні елементи Beancount, які підтримуються автором та офіційними контриб'юторами.

| Ресурс               | Опис                                                                                                                                                                                                                                                     |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Beancount (Core)** | Рушій, який зчитує ваш файл головної книги (ledger), забезпечує дотримання правил подвійного запису та генерує звіти. Він надає основні утиліти командного рядка, такі як `bean-check` та `bean-format`. Усі інші інструменти побудовані на його основі. |
| **Головна сторінка** | [beancount.github.io](https://beancount.github.io/)                                                                                                                                                                                                      |
| **Вихідний код**     | [github.com/beancount/beancount](https://github.com/beancount/beancount)                                                                                                                                                                                 |
| **Документація**     | [GitHub Pages](https://beancount.github.io/docs/) та [Google Docs](https://docs.google.com/document/d/1RaondTJCS_IUPBHFNdT8oqFKJjVJDsfsn6JEjBG04eA/edit)                                                                                                 |
| **Зовнішні внески**  | [Офіційний список внесків спільноти](https://beancount.github.io/docs/external_contributions.html)                                                                                                                                                       |
| **Beanquery**        | Потужний SQL-подібний інструмент запитів (`v3`) для виконання розширених запитів (наприклад, `SELECT ... FROM ... WHERE ...`) до вашої книги для створення спеціальних аналізів.                                                                         |

### 2. Інтерфейси користувача

Ці інструменти надають візуальні інтерфейси для вивчення та редагування ваших фінансових даних.

| Інструмент                 | Опис                                                                                                                                                                                                   |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Fava**                   | Основна, повнофункціональна вебпанель для Beancount. Вона надає інтерактивні діаграми, деталізовані таблиці, редагування у браузері та систему розширень для додавання функцій, таких як бюджетування. |
| **Fava-GTK**               | Нативний додаток для робочого столу GNOME, який обгортає Fava для зручної роботи на десктопі.                                                                                                          |
| **Beancount Mobile**       | Мобільний додаток для введення даних та додавання транзакцій на ходу.                                                                                                                                  |
| **Beancount Telegram Bot** | Telegram-бот для швидкого додавання транзакцій у вашу книгу через чат.                                                                                                                                 |

### 3. Імпорт транзакцій

Імпорт — це процес перетворення даних із фінансових установ (наприклад, банківських CSV або PDF-файлів) у записи Beancount.

| Інструмент                  | Опис                                                                                                                                                          |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Beangulp (v3)**           | Сучасний автономний фреймворк для створення імпортерів. Він обробляє зовнішні файли за допомогою скриптів Python (плагінів) для створення директив Beancount. |
| **Smart Importer**          | Інструмент, який доповнює імпортери машинним навчанням для автоматичного прогнозування та призначення категорій.                                              |
| **Beancount Reds Ingestor** | Колекція імпортерів із загальною бібліотекою для обробки файлів CSV та OFX.                                                                                   |
| **double-entry-generator**  | Імпортер на основі правил, орієнтований на китайські сервіси, такі як Alipay та WeChat Pay.                                                                   |

#### Спільнотні імпортери (за країнами)

Велика колекція скриптів для конкретних банків та сервісів, що підтримується спільнотою.

- **Китай**

  - Alipay / 支付宝: [deb-sig/double-entry-generator](https://github.com/deb-sig/double-entry-generator), [wzyboy/importer](https://github.com/wzyboy/awesome-beancount/blob/master/importers/alipay_acclog.py)
  - China Merchants Bank (CMB): [Дебетова картка](https://github.com/wzyboy/awesome-beancount/blob/master/importers/cmb_debit_cards.py), [Кредитна картка](https://github.com/wzyboy/awesome-beancount/blob/master/importers/cmb_credit_cards.py)
  - WeChat Pay / 微信支付: [deb-sig/double-entry-generator](https://github.com/deb-sig/double-entry-generator)

- **Франція**

  - Caisse d'Epargne: [beancount-ce](https://github.com/ArthurFDLR/beancount-ce)
  - Boursorama, Amex: [Beancount-myTools](https://github.com/grostim/Beancount-myTools)

- **Німеччина**

  - Commerzbank: [beancount-commerzbank](https://github.com/siddhantgoel/beancount-commerzbank)
  - Deutsche Kredit Bank (DKB): [beancount-dkb](https://github.com/siddhantgoel/beancount-dkb)
  - ING: [beancount-ing](https://github.com/siddhantgoel/beancount-ing)
  - N26: [beancount-n26](https://github.com/siddhantgoel/beancount-n26)
  - Volksbank & GLS-Bank: [beancount-importer-volksbank](https://github.com/Fjanks/beancount-importer-volksbank)

- **Індія**
  - SBI, BOI, Paytm, HSBC, ICICI: [beancount-importers-india](https://github.com/dumbPy/beancount-importers-india)

- **Нідерланди**
  - ABN AMRO: [beancount-abnamro](https://github.com/deepakg/beancount-abnamro)

- **Швейцарія**

  - Загальні: [tariochbctools](https://tariochbctools.readthedocs.io/) (BCGE, Neon, Raiffeisen, ZKB, Fidelity)
  - Finpension: [drnuke-bean](https://github.com/Dr-Nuke/drnuke-bean?tab=readme-ov-file#finpension-importer)
  - PostFinance: [tariochbctools](https://github.com/tarioch/beancounttools/blob/master/src/tariochbctools/importers/postfinance/importer.py), [drnuke-bean](https://github.com/Dr-Nuke/drnuke-bean?tab=readme-ov-file#postfinance-importer-swiss)

- **Велика Британія**

  - Monzo, Revolut, Wise: [Evernight/beancount-importers](https://github.com/Evernight/beancount-importers/)
  - Revolut, Wise: [tariochbctools](https://tariochbctools.readthedocs.io/en/latest/importers.html#revolut)

- **США**

  - Amex, Chase, Citi, Schwab: [mterwill/gist](https://gist.github.com/mterwill/7fdcc573dc1aa158648aacd4e33786e8#file-importers-amex-py)
  - Capital One: [mtlynch/beancount-capitalone](https://github.com/mtlynch/beancount-capitalone)
  - Chase: [mtlynch/beancount-chase-bank](https://github.com/mtlynch/beancount-chase-bank), [ArthurFDLR/beancount-chase](https://github.com/ArthurFDLR/beancount-chase)
  - Clipper: [beancount-clipper](https://git.sr.ht/~goorzhel/beancount-clipper)
  - Mercury: [mtlynch/beancount-mercury](https://github.com/mtlynch/beancount-mercury)

- **Блокчейн**
  - [tariochbctools](https://tariochbctools.readthedocs.io/en/latest/importers.html#blockchain)

### 4. Підтримка редакторів та інструментарій

Інструменти, які інтегрують Beancount у ваше середовище розробки для спрощення редагування та обслуговування.

- **Підтримка IDE:** Плагіни, що забезпечують підсвічування синтаксису, автодоповнення та перевірку балансу «на льоту».

  - [VSCode](https://marketplace.visualstudio.com/items?itemName=Lencerf.beancount)
  - [Emacs](https://github.com/beancount/beancount-mode)
  - [Vim](https://github.com/nathangrigg/vim-beancount)
  - [Zed](https://github.com/zed-extensions/beancount)
  - [Sublime Text](https://github.com/norseghost/sublime-beancount)
  - [Atom](https://atom.io/packages/beancount)
  - [Beancount Language Server](https://github.com/polarmutex/beancount-language-server) (для будь-якого LSP-сумісного редактора)

- **Автоматизація та утиліти:**

  - `bean-add`: Інтерактивне додавання транзакцій через командний рядок.
  - `beancount-black`: Безкомпромісний форматувальник коду для файлів Beancount.
  - `beancount-categorizer`: Автоматична категоризація транзакцій за допомогою правил регулярних виразів.
  - `beanahead`: Керування та прогнозування майбутніх транзакцій.

- **Інструменти міграції даних:** Утиліти для конвертації даних з інших систем обліку.

  - З GnuCash: [henriquebastos/gc-to-bc](https://github.com/henriquebastos/gnucash-to-beancount/), [dtrai2/gc-to-bc](https://github.com/dtrai2/gnucash-to-beancount/)
  - З Ledger/hledger: [travisdahlke/gist](https://gist.github.com/travisdahlke/71152286b0a8826249fe), [zacchiro/ledger2beancount](https://github.com/zacchiro/ledger2beancount)
  - З YNAB: [hoostus/beancount-ynab](https://github.com/hoostus/beancount-ynab)

### 5. Плагіни (Розширення книги)

Внутрішні модулі Python, які запускаються під час обробки для застосування користувацьких правил, автоматизації транзакцій або додавання нових функцій.

- **Бюджетування:**
  - [fava-envelope](https://github.com/polarmutex/fava-envelope): Розширення Fava для бюджетування за методом конвертів.

- **Автоматизація та перевірки:**

  - [autobean.share](https://github.com/SEIAROTg/autobean/tree/master/autobean/share): Розподіл витрат та управління боргами.
  - [autobean.sorted](https://github.com/SEIAROTg/autobean/tree/master/autobean/sorted): Забезпечує хронологічний порядок транзакцій.
  - [beancount-checkclosed](https://github.com/daniel-wells/beancount_checkclosed): Автоматична перевірка нульового балансу на закритих рахунках.

- **Маніпуляції з даними:**

  - [autobean.narration](https://github.com/SEIAROTg/autobean/tree/master/autobean/narration): Автоматична генерація описів транзакцій.
  - [beancount-lazy-plugins.filter\_map](https://github.com/Evernight/beancount-lazy-plugins/tree/main?tab=readme-ov-file#filter_map): Застосовує операції до відфільтрованої групи транзакцій.

### 6. Джерела цін

Скрипти, що отримують історичні та поточні ціни на товари, акції та валюти для відстеження вартості інвестицій.

- [beancount-exchangerates](https://github.com/xuhcc/beancount-exchangerates): Для фіатних валют через API, такі як `frankfurter.dev`.
- [pricehist](https://gitlab.com/chrisberkhout/pricehist): Інструмент для отримання цін з багатьох джерел.
- [beancount-cryptoassets](https://github.com/xuhcc/beancount-cryptoassets): Для отримання цін на криптовалюти.
- [tariochbctools](https://tariochbctools.readthedocs.io/): Включає джерело цін для Interactive Brokers.

***

## Навчання та спільнота

### Книги та поглиблені посібники

- **Tracking Personal Finances using Python:** Книга, що містить вичерпний посібник зі створення системи управління особистими фінансами за допомогою Beancount. ([Вебсайт](https://personalfinancespython.com/))
- **Серія блогів китайською мовою (BYVoid):** [Частина 1: Чому?](https://byvoid.com/zhs/blog/beancount-bookkeeping-1), [Частина 2: Дебет і Кредит](https://byvoid.com/zhs/blog/beancount-bookkeeping-2)

### Вибрані дописи в блогах

- **Англійською**

  - [Рахуємо боби — і не тільки — з Beancount](https://lwn.net/Articles/751874/)
  - [Управління особистими фінансами за допомогою Python](https://sgoel.dev/posts/managing-personal-finances-using-python/)
  - [Прямий вступ до Beancount](https://web.archive.org/web/20221119110728/https://blog.leononame.dev/2019/08/beancount/)

- **Французькою**
  - [Beancount або бухгалтерський облік для хакерів](https://cyril.deguet.com/fr/2015/09/03/beancount-comptabilite-pour-hackers/)

- **Китайською**
  - [Beancount —— 命令行复式簿记](https://wzyboy.im/post/1063.html)

### Спільнота

- **Список розсилки:** [Google Groups](https://groups.google.com/g/beancount) (Основний форум для обговорення)
- **Живий чат (IRC):** [#beancount на web.libera.chat](https://web.libera.chat/gamja/?channels=%23beancount)
- **Telegram (китайською):** [t.me/beancount\_zh](https://t.me/beancount_zh)

***

## Комерційні послуги та додатки

Для користувачів, які хочуть використовувати можливості Beancount, не займаючись керуванням інфраструктурою самостійно.

| Сервіс           | Опис                                                                                                                                                                                                                                                                                             |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Beancount.io** | Платформа SaaS (програмне забезпечення як послуга), що надає готові до роботи екземпляри Beancount та Fava. Вона також пропонує спеціальні мобільні додатки для [iOS](https://apps.apple.com/app/id1527950512) та [Android](https://play.google.com/store/apps/details?id=io.beancount.android). |

## Використовуйте можливості звичайного тексту.

Створіть облікову книгу Beancount або налаштуйте власне середовище за посібником.

[Почати безкоштовно](https://beancount.io/sign-up/?next=%2Fledger%2F) [Посібник для початку роботи](https://beancount.io/uk/docs/getting-started)

## Where to look next

- [Sitemap](https://beancount.io/sitemap.xml) - all pages with hreflang alternates
- [LLMs index](https://beancount.io/llms.txt) - curated links for AI agents (also /llms-full.txt for full docs)
- [Documentation](https://beancount.io/docs) - every doc is also available as text/markdown via .md suffix or Accept negotiation
- [REST API reference](https://beancount.io/docs/api-reference) - interactive endpoints, schemas, authentication, and code samples
- [OpenAPI spec](https://beancount.io/openapi.json) - OpenAPI 3.1 spec for this website's public content endpoints; the product contract for ledger operations is at https://beancount.io/api-gateway/v1/openapi.json
- [GraphQL](https://beancount.io/graphql) - public, read-only content API over the blog and research logs (no credentials, no ledger data): 12 query fields over 23 types
- [MCP server](https://beancount.io/mcp) - Model Context Protocol at https://beancount.io/api-gateway/mcp
