Beancount

Overview

Beancount is free double-entry bookkeeping software that stores transactions in text files and uses them to produce reports. It is best for people comfortable managing a ledger directly who value inspectable records and deliberate control over processing. Its offline-friendly workflow is compelling, but version 3’s discontinued web interface and custom reports rule it out for users who want those tools built in.

Key features

The ledger file is the center of Beancount’s workflow. bean-check checks ledger files, while bean-query extracts tables from them. That combination gives users a way to validate their records and examine the underlying data, but it assumes they are willing to work with files and command-line tools rather than a conventional accounting interface.

Beancount’s documentation covers importing files downloaded from financial institutions, along with tools and libraries that can automate parts of the process. The bean-price tool fetches price data for commodities held in accounts; prices are not fetched automatically when a ledger is processed. That keeps reports deterministic and allows offline processing, at the cost of requiring users to manage price updates themselves. The manual also covers exporting a portfolio to external tracking websites.

Version 3 is the current stable branch and remains under maintenance and development; version 2 is frozen and obsolete. Some tools were removed in v3, and bean-report and bean-web are deprecated. Custom reports and bean-web are discontinued, so users who depend on those capabilities should look elsewhere rather than expect the older workflow to continue.

Installation guidance recommends uv and also covers pipx, pip, and source installation. Windows instructions are provided for v3. Contributed editor support includes Emacs, Sublime Text, Vim, and two Visual Studio Code extensions. The documentation says ledger processing uses file contents and does not automatically retrieve internet prices, a useful fit for users who want offline processing. Beancount is licensed under GNU GPLv2 only; questions go to its mailing list and bug reports to GitHub issues.

Pricing

Beancount costs free under its open-source plan. There is no free trial, but the software itself is free, so there is no paid tier to unlock after a trial. This suits individuals and others seeking a no-cost ledger tool; the trade-off is that users must be comfortable with its file-based approach and the v3 tool limitations.

Platforms

Beancount supports Linux, macOS, Windows, web, API, and self-hosted environments. The installation guide includes Windows instructions for version 3, while the project’s web interface is discontinued in that version; users should not choose it expecting a maintained built-in web workflow.

Who it's for

Beancount is a strong fit for people who want personal bookkeeping in a transparent text ledger, need multi-currency accounting, and value validation, queries, offline processing, or portfolio export. It is less suitable for users who prefer a conventional graphical workflow, want prices fetched automatically, or rely on custom reports or the discontinued web interface.

Pros and cons

• Pro: Text files make the ledger inspectable, while bean-check and bean-query provide tools for checking records and extracting data.
• Pro: Processing does not automatically retrieve prices, which supports deterministic reports and offline use.
• Pro: Import guidance and portfolio export documentation cover ways to bring in and use financial data beyond the ledger itself.
• Con: The file-and-command-line workflow favors technically comfortable users over those seeking a conventional accounting interface.
• Con: Users must arrange price updates themselves, and version 3 has discontinued custom reports and bean-web while removing some tools.

Alternatives

For a broader set of general ledger software, compare these options:

• GnuCash is a free desktop accounting option for personal and small-business use, with Linux, macOS, and Windows support; choose it if that desktop-oriented scope fits better than Beancount’s text-ledger workflow.
• BUSY offers a free web plan for billing and accounting, including multiple companies and financial years; choose it if those stated capabilities match your needs.
• GNUKhata is free and open source, supports Linux, self-hosting, web, and Windows, and its current v8.0 supports Docker installation; consider it if those deployment options are a better fit.
• FrontAccounting is free accounting software under the GNU General Public License, with web and self-hosted platforms; consider it if that platform mix suits you.
• Infor Public Sector has custom pricing; contact Infor for details.
• Adagio Accounting costs $100 a month for a plan that includes ledger and financial reporting, payables and EFT, BankRec, cloud management tools, Datacare, and one admin and one general user license.
• AccountMate offers perpetual-license and rental-agreement options with pricing not stated, plus local or hosted deployment options.
• Flexi is a paid option available via API, self-hosted, and web platforms.

Verdict

Choose Beancount if you want free, multi-currency bookkeeping built around a text ledger and value validation, querying, and offline processing. Its main advantage is the control and predictability of that workflow; its main drawback is that version 3 no longer provides the web interface or custom reports, making it a poor fit for users who need them.