Beancount

Beancount is a double-entry bookkeeping language for keeping financial records in text files and generating reports. It is best suited to people willing to manage a ledger directly and value control over how their data is processed. Its strongest case is a transparent, offline-capable workflow; version 3’s removed and deprecated tools make it a less natural fit for users who want a built-in web interface.

Overview

Beancount treats the ledger file as the core of the bookkeeping system rather than putting a graphical accounting application at the center. That approach suits users who want inspectable records and are comfortable working with files and command-line tools. The project grew out of its author’s own accounting needs and is maintained as open-source software for others to use.

Version 3 is the current stable branch and is under continued maintenance and development. Version 2 is frozen and obsolete, so new users should start with v3 and account for its changed toolset: some tools were removed, while bean-report and bean-web are deprecated. Custom reports and bean-web are discontinued in v3, a significant trade-off for anyone expecting the older web workflow.

Key features

Ledger checks and queries: bean-check checks ledger files, while bean-query extracts tables of data from them. Together, these tools make it possible to validate records and ask structured questions of the ledger without changing the text-file foundation.

Imports and price handling: The documentation covers importing files downloaded from financial institutions, as well as tools and libraries that can automate parts of the process. This can reduce repetitive work, but users should expect to manage an import workflow rather than rely on automatic institution connections. bean-price can fetch prices for commodities held in accounts, but Beancount does not retrieve prices automatically when processing a ledger. That choice keeps processing offline and reports deterministic, at the cost of requiring deliberate price updates when current valuations matter.

Portfolio export: The user manual documents exporting a portfolio to external portfolio-tracking websites, useful for users who want to carry portfolio data beyond the ledger.

Pricing

Beancount is free and open source under the GNU GPLv2 only. Its Beancount plan costs free; there is no free trial. There are no paid tiers or seat and quota distinctions to weigh, making it an option for users who want bookkeeping software without a subscription. The trade-off is a file- and tool-centered workflow rather than a bundled web experience in v3.

Platforms

Beancount supports API, Linux, macOS, self-hosted, web, and Windows. The installation guide includes Windows instructions for v3. It recommends installing with uv and also describes pipx, pip, and source installation. Contributed editor support includes Emacs, Sublime Text, Vim, and two Visual Studio Code extensions, giving users several ways to work with ledger files in an editor they already use.

Who it's for

Beancount is a good fit for individuals and technically comfortable users who want multi-currency double-entry bookkeeping, direct access to their records, and control over when prices are fetched. Its offline processing and query tools are particularly useful when reproducible reports and inspectable data matter more than a graphical interface.

Look elsewhere if your accounting workflow depends on a maintained built-in web interface or custom reports: those are discontinued in v3, and bean-web and bean-report are deprecated. Users who prefer not to maintain text files or manage imports should also consider a different style of accounting software.

Pros and cons

• Pro: Free, GPLv2-only software keeps the cost barrier low and permits users to inspect their ledger files directly.
• Pro: Ledger validation and querying provide concrete tools for checking records and extracting data.
• Pro: Price retrieval is not automatic during processing, supporting offline, deterministic reports.
• Con: A text-file ledger and installation options such as uv, pipx, or source installation favor users comfortable managing software and data files.
• Con: Version 3 discontinues custom reports and bean-web, limiting its appeal to users seeking an integrated web workflow.
• Con: Imported financial data and commodity prices require user-managed steps rather than automatic processing.

Alternatives

General Ledger Software is the broader category to explore when comparing ledger tools.

GnuCash is a free alternative for users who prefer desktop accounting software on Linux, macOS, or Windows; its plan covers personal and small-business accounting. GNUKhata is another free option, with Linux, self-hosted, web, and Windows platforms and Docker installation support in its current v8.0. FrontAccounting is worth considering for users seeking free accounting software designed for self-hosted or web use.

BUSY offers a free billing and accounting plan for web users, as well as a free trial. Infor Public Sector, Adagio Accounting, Blackbaud Financial Edge NXT, and Flexi are other alternatives.

Verdict

Choose Beancount if you want free, multi-currency double-entry bookkeeping built around a ledger you can inspect, validate, query, and process offline. Its strongest advantage is the control and predictability of that file-based workflow. If you need a maintained built-in web interface or custom reports in v3, look elsewhere.