Beancount
beancount.github.io
- Free plan
- Windows
- macOS
- Linux
- Web
- API
- Self-hosted
What Beancount is
Beancount is a double-entry bookkeeping language for recording financial transactions in text files and generating reports. The `bean-check` command checks ledger files, while `bean-query` extracts tables of data from them. Documentation covers importing files downloaded from financial institutions and tools for automating parts of that process. The `bean-price` tool can retrieve prices for commodities held in accounts, but ledger processing does not fetch prices automatically. Reports can therefore run offline from the ledger contents. Beancount supports multiple currencies and documents portfolio export to external portfolio-tracking websites. It is free, open-source software under GNU GPLv2 only, with a free plan and no free trial. The project identifies version 3 as its current stable, maintained version; version 2 is frozen and obsolete. The v3 guide notes that some tools were removed and that `bean-report` and `bean-web` are deprecated. Installation instructions cover uv, pipx, pip and source, including Windows instructions for v3. Contributed editor support includes Emacs, Sublime Text, Vim and two Visual Studio Code extensions.
Who it suits
Beancount suits people who want to keep financial records in text-based ledgers and generate reports, including for personal accounting.
Good to know, and what to watch
- Ledger files can be checked and queried from command-line tools.
- Supports multiple currencies.
- Reports can run offline without automatic price retrieval.
- Installation instructions include Windows support for v3.
- Version 2 is frozen and obsolete.
- Some tools were removed in version 3.
- `bean-report` and `bean-web` are deprecated in v3.
Plans
Every plan and priceBeancount
Free plan
Getting started
- Visit https://beancount.github.io/ and review the documentation.
- Install Beancount using the recommended uv route, or choose pipx, pip, or source installation.
- Follow the installation guide's Windows instructions if installing version 3 on Windows.
- Create or import a ledger file, then use `bean-check` to check it.
- Use `bean-query` to extract tables, and consult the documentation for importing files or retrieving commodity prices.
Limits to check
Version 3 discontinued custom reports and bean-web, and its installation guide notes that some tools were removed. Version 2 is frozen and obsolete.
The Club's review
Overview
Beancount is a strong fit for people who want their accounts kept in a text ledger they can inspect and process themselves. It is free and supports multi-currency bookkeeping, but its command-line, file-based approach asks users to take an active role in maintaining the books.
The project began as a personal accounting tool and is now maintained as open-source software for others. Version 3 is the current stable branch; version 2 is frozen and obsolete. That gives new users a clear starting point, though v3’s reduced toolset matters to anyone expecting a built-in web workflow or custom reports.
Key features
Beancount makes the ledger file the source of truth. The bean-check command checks ledger files, giving users a way to validate bookkeeping as they maintain it. bean-query extracts tables from a ledger, which is useful for answering questions from the underlying records rather than relying only on preset outputs.
The documentation covers importing files downloaded from financial institutions and tools or libraries that can automate parts of that process. This can reduce repetitive work, but importing is still a workflow users need to arrange. The bean-price tool fetches prices for commodities held in accounts. Because ledger processing does not fetch prices automatically, reports can run offline and remain deterministic; users who need current valuations must manage price updates themselves.
The manual also describes exporting a portfolio to external tracking websites. For users who value a portable ledger and deliberate data handling, these tools offer useful control. Those looking for a continuously updated, all-in-one interface may find the workflow demanding.
Beancount’s documentation recommends installation with uv and also covers pipx, pip, and source installation. Contributed editor support is available for Emacs, Sublime Text, Vim, and two Visual Studio Code extensions. These options serve users comfortable setting up a development-style toolchain; they do not replace a graphical bookkeeping application.
Version 3 removed some tools, and bean-report and bean-web are deprecated. Custom reports and bean-web are discontinued in v3, which narrows the built-in reporting and web options. Users whose process depends on those components should weigh that limitation before choosing Beancount.
Pricing
Beancount is free and open source under the GNU GPLv2-only license. Its free plan costs free and provides the bookkeeping software without a subscription fee. There is no free trial because the software is free to use. This suits individuals who want to keep costs at zero and can work within its file-based model; the trade-off is that they manage their ledger and supporting workflow themselves.
Platforms
Beancount is available for Linux, macOS, Windows, web, self-hosted use, and through an API. The v3 installation guide includes Windows instructions. The project’s discontinued web component means the web platform label should not be read as a promise of the former bean-web interface in v3.
Who it's for
Beancount is best for individuals who want explicit control over personal accounting, multi-currency records, and the way ledger data is processed. It can also suit technically confident users who want to automate parts of importing or build queries around their financial records. It is a weaker match for first-timers seeking a guided graphical workflow, or for anyone who expects a maintained built-in web interface and custom-report tools.
For questions, the project directs users to its mailing list; bug reports go through GitHub issues. That support model is a sensible fit for open-source users comfortable seeking help through community channels.
Pros and cons
- Pros: Free, open-source bookkeeping with multi-currency support, ledger checks, and queries gives users transparent control over their records without a subscription cost.
- Pros: Processing does not retrieve prices automatically, so users can run reports offline and get deterministic results.
- Pros: Import guidance, automation tools, and portfolio export provide ways to connect ledger work with financial institutions and external trackers.
- Cons: A text-file ledger and command-line tools require users to take responsibility for maintaining and processing their books.
- Cons: Price updates are not automatic, so valuations that depend on current market data require deliberate upkeep.
- Cons: Version 3 discontinues custom reports and bean-web, limiting the built-in web and reporting workflow for users who need those features.
Alternatives
General Ledger Software is a useful place to compare products across the category.
Choose hledger if you want another free accounting option with API, web, and self-hosted platform availability. Ledger is a free BSD-licensed command-line accounting option for Linux, macOS, and Windows. For a desktop approach to personal and small-business accounting, consider GnuCash, which is free for Linux, macOS, and Windows.
Frappe Books is a free, open-source option that can be installed on a Frappe site and supports mobile, desktop, and web platforms. GNUKhata is another free open-source choice, with current v8.0 supporting Docker installation. FrontAccounting is free accounting software for self-hosted web use. LedgerSMB is free, open-source software for self-hosted use. If you want a freemium billing and accounting plan with a free Express tier, consider BUSY.
Verdict
Choose Beancount if you want free, multi-currency bookkeeping built around an inspectable text ledger, with checks and queries and the option to process records offline. Its main appeal is control over the data and a predictable workflow. Look elsewhere if you need a maintained built-in web interface, custom reports, or a more guided accounting experience.
The verdict
Beancount offers text-based double-entry bookkeeping with ledger checks, queries and report generation. Its v3 documentation also flags removed tools and deprecated report and web components.
Questions people ask
How much does Beancount cost?
The Beancount plan is free. The project describes it as free, open-source software under GNU GPLv2 only.
Is there a free trial?
No. Beancount has a free plan and no free trial.
Which platforms are supported?
The listed platforms are API, Linux, macOS, self-hosted, web, and Windows. The installation guide includes Windows instructions for version 3.
Is Beancount open source?
Yes. The project says it is distributed under GNU GPLv2 only.
What is the current version?
The project identifies version 3 as the current stable branch and says it is maintained and under development. Version 2 is frozen and obsolete.
How can users get support?
The project directs questions to its mailing list and bug reports to GitHub issues.
What the maker publishes
- Audience
- The author says the project began as a tool for doing personal accounting and is intended to be useful to others as open-source software. source
- Data import
- The documentation describes importing external files downloaded from financial institutions and tools and libraries to automate parts of that process. source
- Editor integrations
- The installation guide lists contributed support for Emacs, Sublime Text, Vim, and two Visual Studio Code extensions. source
- External data
- Beancount documentation covers importing data from files downloaded from financial institutions and tools to automate parts of that process. source
- Founded
- 2007 source
- Installation
- The documentation recommends running Beancount with uv and also describes installation with pipx, pip, or from source. source
- Intended use
- The author says the project began as a tool for doing his own accounting and was built to be useful to others. source
- Ledger checks
- The bean-check tool checks a Beancount ledger file. source
- Ledger validation
- The bean-check command checks Beancount input files. source
- License and cost
- The project README says Beancount is distributed under GNU GPLv2 only and describes its open source stance as free. source
- Platforms
- The installation guide includes Windows instructions and notes that Beancount uses Python 3.8 or above. source
- Portfolio export
- The user manual includes documentation on exporting a portfolio to external portfolio-tracking websites. source
- Price behavior
- Beancount does not fetch prices automatically when processing a ledger, so reports can be deterministic and run offline. source
- Prices
- The bean-price tool can fetch price data for commodities held in accounts. source
- Purpose
- Beancount is a double-entry bookkeeping language for recording financial transactions in text files and generating reports. source
- Query
- Bean-query lets users extract tables of data from a Beancount ledger file. source
- Querying
- The documentation describes bean-query as a command-line tool for extracting tables of data from a ledger file. source
- Security
- The project page identifies the code license as GNU GPLv2 only. source
- Security and privacy
- The documentation says ledger processing uses the file contents and does not automatically retrieve prices from the internet. source
- Support
- The project directs users to its mailing list for questions and GitHub issues for bug reports. source
- Support
- Users can ask questions on the Beancount mailing list or report problems through a GitHub issue. source
- Version
- The project identifies branch v3 as its current stable version and says it is under continued maintenance and development. source
- Version 3 limits
- The installation guide says some tools were removed from v3, and that bean-report and bean-web have been deprecated. source
- Version status
- The project README identifies version 3 as the current stable version and says version 2 is frozen and obsolete. source
Checked against the maker's pages on 7 Oct 2026.