Beancount, rewritten in Rust

Modern Plain Text Accounting

Name: rustledger
Author: rustledger

Accounting in plain text, under your control, forever.

Star on GitHub ...

$ cargo install rustledger

$ cargo binstall rustledger

View on crates.io

Requires Rust toolchain.

$ brew install rustledger

For macOS and Linux via Homebrew.

$ nix run github:rustledger/rustledger

Available in nixpkgs. Also works with nix run nixpkgs#rustledger.

$ sudo dnf copr enable rustledger/rustledger

$ sudo dnf install rustledger

$ yay -S rustledger

$ yay -S rustledger-bin

> scoop bucket add rustledger https://github.com/rustledger/scoop-rustledger

> scoop install rustledger

$ docker run -v $PWD:/data ghcr.io/rustledger/rustledger

$ npm install @rustledger/wasm

WASM bindings for Node.js and browser usage.

See all binaries on GitHub Releases.

What is plain text accounting?

Your finances in simple text files you control forever.

Your data, your files

Simple .beancount files work with any text editor. No vendor lock-in, no subscriptions, no cloud required.

Git-friendly

Track every change with version control. See exactly what changed and when. Collaborate with diffs.

Future-proof

Text files from 1990 still work today. Your financial history will outlive any app or company.

How does rustledger compare?

Plain text accounting tools at a glance

	rustledger	Beancount	Ledger	hledger
Language	Rust	Python	C++	Haskell
Syntax	Beancount	Beancount	Ledger	Ledger
Validation	Strict	Strict	Optional	Optional
Validation (10k txns)	~34ms	~880ms	~114ms	~534ms
Balance Report	~47ms	~1162ms	~64ms	~595ms
Dependencies	None	Python + pip	None	GHC runtime
Booking methods	7	7	Manual	Manual
Plugins	20 + Python	Python	No	No
WebAssembly	Yes	No	No	No

Your existing .beancount files work without changes

Same commands you know

$ bean-check ledger.beancount

$ bean-format --in-place ledger.beancount

$ bean-query ledger.beancount

$ bean-report ledger.beancount balances

Full BQL support

beancount> SELECT account, SUM(position)

...> WHERE account ~ "Expenses"

...> GROUP BY account

...> ORDER BY SUM(position) DESC

Everything you need

Full syntax support

All 12 directive types, cost specs, price annotations, arithmetic

Zero dependencies

Single binary, no Python or runtime required

20 built-in plugins

implicit_prices, auto_accounts, pedantic, and more

WASM plugins

Extend with WebAssembly for sandboxed custom logic

7 booking methods

STRICT, FIFO, LIFO, HIFO, AVERAGE, and more

30 error codes

Comprehensive validation with clear messages