Beancount

Beancount is a text-based double-entry bookkeeping system for people who want their financial record in an inspectable file rather than a conventional accounting interface. It is a strong fit for technically comfortable individuals and small teams managing multi-currency books, while users who depend on an integrated web reporting workflow should look elsewhere.

Overview

Beancount makes the ledger file the centre of bookkeeping. Transactions are recorded in a dedicated language, then processed into reports, checks and queries. That design gives users direct control over the underlying record and makes the accounting data portable, but it also assumes comfort with text files, command-line tools and a deliberate workflow rather than point-and-click entry.

The project began as its author’s personal accounting tool and is maintained as open-source software intended for wider use. Version 3 is the current stable branch and remains under development; version 2 is frozen and obsolete. New installations should therefore target v3 and account for its changed toolset: some utilities were removed, custom reports are discontinued, and bean-report and bean-web are deprecated.

Key features

Validation and querying:bean-check checks a Beancount ledger file, helping identify invalid input before relying on its reports. bean-query extracts tables from ledger data, which is useful when standard output is not enough and you need a focused view of transactions or balances.

Imports and prices: Documentation covers importing files downloaded from financial institutions, along with tools and libraries for automating parts of that process. bean-price can fetch prices for commodities held in accounts. Beancount does not retrieve prices automatically while processing a ledger, so reports remain deterministic and can run offline; the trade-off is that price updates require an explicit step. The manual also covers exporting a portfolio to external portfolio-tracking websites.

Editor support: Contributed integrations are documented for Emacs, Sublime Text, Vim and two Visual Studio Code extensions. These options suit users who want ledger editing inside a familiar development environment, but they do not replace the discontinued v3 web interface.

Pricing

Beancount costs free on its sole Beancount plan. It is free open-source software, with no trial period because there is no paid tier to evaluate. The GNU GPLv2-only license permits a self-managed deployment without subscription charges; support is directed to the project mailing list for questions and GitHub issues for bug reports.

Platforms

Beancount supports API, Linux, macOS, self-hosted, web and Windows environments. The v3 installation guide includes Windows instructions. Recommended installation uses uv, with pipx, pip and source installation also documented. The self-hosted and file-oriented model gives users control over where ledger contents are processed.

Who it's for

Choose Beancount if you want multi-currency bookkeeping built around plain text, need ledger validation and extractable tables, and value processing that does not automatically contact the internet for prices. It is particularly suitable for technically confident individuals or small teams willing to maintain imports and price updates themselves.

It is a poor fit for users who expect a maintained browser interface, built-in custom-report tooling or a conventional desktop accounting experience. The v3 removal and deprecation of web and reporting utilities make that expectation a reason to choose another product.

Pros and cons

Pros: Text files keep the accounting record inspectable and portable.

Pros: bean-check and bean-query provide explicit validation and tabular analysis.

Pros: Offline, non-automatic price handling makes reports reproducible.

Pros: Multi-currency support and documented financial-institution imports cover serious personal bookkeeping needs.

Cons: Users must be comfortable with a ledger language and command-line-oriented tools.

Cons: v3 discontinues custom reports and bean-web, while bean-report and bean-web are deprecated.

Cons: Price retrieval and parts of import automation require deliberate user-managed steps.

Alternatives

For a broader comparison, see General Ledger Software.

BUSY is the better choice for a free web billing and accounting plan with multiple companies and financial years.

Frappe Books suits users wanting free, open-source software installable on their own Frappe site across desktop, mobile and web platforms.

hledger is a direct free alternative with a similarly broad API, desktop, self-hosted and web platform footprint.

GNUKhata fits users seeking free open-source accounting with Docker-supported self-hosting.

Ledger is another free BSD-licensed command-line accounting option for Linux, macOS and Windows.

GnuCash is preferable when you want free desktop software for personal and small-business accounting.

Infor ERP targets organisations seeking an industry-specific paid CloudSuite package with custom pricing.

FrontAccounting is a free GNU-licensed web or self-hosted accounting choice.

Verdict

Beancount is the right choice for users who want rigorous, multi-currency bookkeeping in text files, with validation, querying and reproducible offline processing at no cost. Look elsewhere if a maintained web interface, custom reports or graphical accounting workflow is central to your requirements.