Ledger/01

A self-hostable personal and household finance app.
Track every wallet, in any currency, on every device, on a server you own.
It costs close to nothing to run.

The Ledger/01 dashboard: wallet balances, totals for the period, a balance chart and income and expenses by week

Why Ledger/01
Everything a household ledger needs
Up and running in five minutes
Your bank statements, without the typing
Ask your AI about your money
Host it yourself on AWS
Serverless, so it costs cents
Open source, open contract
Contributing
Security and license

Why Ledger/01

You own your data It runs in your AWS account, against your database. Download the whole ledger as one file whenever you like. Your data →	One ledger, every device Install it on your phone and laptop, and share one household with the people you allow. Features →
Drop in a statement, done Drag your bank's CSV or Excel file onto the page. Duplicates, discounts and refunds are sorted out for you. Importing →	Costs cents a month Everything scales to zero. A household's usage fits in AWS's and Neon's free tiers. Costs →
Ask your AI Connect Claude and ask "am I spending more on takeout than last month?". It can read, never change. AI assistants →	Open and transparent MIT or Apache-2.0. Every line, every API call and every release note is public. Development →

Everything a household ledger needs

Wallets in any currency, with categories, labels and notes on every transaction. Transfers between
currencies, where you type any two of sent, received and rate. Dashboards, budgets, and recurring
bills that show up in a Future view without touching today's balance.

Read more: the features tour →

Up and running in five minutes

Four commands start Postgres, the API and the web app on your machine, and a dev-only login skips
the Google setup. The guide then walks you through your first wallet, transaction, import and
budget.

Read more: getting started →

Your bank statements, without the typing

Import CSV, XLSX and XLS statements with column mapping and duplicate detection. Discounts and refunds
are matched to the purchases they belong to. Backups restore on any instance, and CSV export opens
straight in a spreadsheet.

Ask your AI about your money

Ledger/01 is an MCP server. Add it to Claude as a connector, sign in, and ask questions about your own
numbers. Access is read-only, and you can disconnect it from Settings at any time.

Read more: AI assistants →

Host it yourself on AWS

One GitHub Actions workflow deploys the whole app to your own AWS account with SST. There are no
long-lived keys: the workflow signs in to AWS with GitHub's OIDC, and your secrets stay in your
repository's production environment.

Read more: self-hosting →

Serverless, so it costs cents

The Go API and the Next.js app run on Lambda behind CloudFront, and Postgres runs on Neon, which
scales to zero. With nothing running, nothing is billed. A typical household's month comes to about
ten cents.

Read more: architecture and costs →

Open source, open contract

A Go API on Connect-RPC, a Next.js web app, and one protobuf contract that generates both clients.
Run task test for integration tests against a real Postgres, and Playwright for end-to-end tests.
Every release follows semantic versioning.

Read more: local development →

Contributing

Bug reports, fixes and new banks are all welcome. Adding your bank is one small Go file and a test.

Read more: CONTRIBUTING.md →

Security and license

Report security issues privately as described in SECURITY.md.

Dual-licensed under either of MIT or Apache-2.0, at your option.

ledger-01