v0.1.0

The first release of Simple Balance: self-hosted personal accounting, built so an AI agent can do the tedious parts without being able to do the dangerous ones.

What it is

Double-entry, append-only books. Every transaction settles to zero in each currency it touches, corrections are posted rather than typed over, and deleting reverses instead of erasing. Balances, cash flow, and spending all read the same posting table, so no two figures can disagree about what happened.

Accounts for assets and liabilities in any currency, including crypto at native precision. Deposits, withdrawals, and transfers, with cross-currency conversions that keep the sent and received amounts apart. Bank CSVs land in a review queue before anything counts.

An MCP server over OAuth with separate read, stage, and write scopes, calling the same code the browser does. Tools outside a token's scope are not discoverable. Settings lists every agent you have approved, and revoking one deletes its tokens rather than waiting for them to lapse.

One deployment holds as many people as you let it, each with their own books, and ALLOWED_EMAILS decides who may join.

Running it

docker pull ghcr.io/thtmnisamnstr/simple-balance:0.1.0

PostgreSQL 15 or newer is the only dependency. Point DATABASE_URL at a server and it creates the database, builds the schema, and does nothing if it is already current. See deployment.

Full notes in the changelog.