A free budgeting app for UK households, with no bank login.
Every account in one place, bills and pay day on a calendar, and your balance forecast months ahead.
Website · Install · Features · Screenshots · On your phone · AI agents
A lightweight, self-hosted personal finance tracker for household finances. No subscriptions, no cloud, no database: just your money, on your server.
Install with a single command:
curl -fsSL https://raw.githubusercontent.com/CoppingEthan/Brisk-Budget/main/deploy.sh | sudo bashThe script will:
- Install Node.js (if it's missing or older than version 20) and git
- Clone Brisk Budget to
/opt/brisk-budget - Set it up as a systemd service that starts on boot
- Start it at
http://localhost:3000(or your server's address on your network)
To use a different port, run PORT=8080 before the command: curl ... | sudo PORT=8080 bash.
Run the same command again. Updating is safe:
- Brisk Budget is stopped and your data folder is backed up before anything changes
- Data from older versions is upgraded automatically (with its own safety copy)
- If anything goes wrong, or the new version doesn't start, the previous version and its data are put back
- Your settings in
/etc/default/brisk-budgetare never touched
To have Brisk Budget check for a new version every night and install it:
curl -fsSL https://raw.githubusercontent.com/CoppingEthan/Brisk-Budget/main/deploy.sh | sudo bash -s -- --auto-updateTurn it off again with --no-auto-update. A version that fails to start is rolled back and skipped until a newer one comes out. Settings › About shows whether automatic updates are on and whether a newer version is available.
- Clone the repository
- Install dependencies:
npm install --omit=dev - Start the server:
npm start - Open your browser to
http://localhost:3000
Requires Node.js 20 or newer.
- Accounts - Bank, savings, credit cards, loans, mortgages, investments and assets, in drag-and-drop groups. Liabilities are entered as the amount you owe.
- Transactions - Search, filter by category, date or direction, running balances, bulk categorise and delete with undo.
- Transfers - Linked transfers that stay in sync from either side. Turn an existing pair of imported transactions into a transfer without creating duplicates.
- Recurring payments - A calendar of what's due, monthly totals, and one-click logging (or let them log themselves on the due date). Brisk Budget suggests recurring payments it spots in your history.
- Mortgages - Interest is added each month on the remaining balance, with equity shown against the property value.
- Investments and assets - Give them a current value, which counts towards your net worth in place of the money paid in.
- Dashboard - Net worth, cash, savings and debt with their 90-day trends (choose one to chart it), a balance chart with a forecast and a likely range, and a money flow diagram.
- CSV import - Works with exports from UK banks, including separate paid in/paid out columns. Spots duplicates, maps categories and remembers your choices per account.
- Backups - Download a backup any time, automatic hourly backups, and restore from the app. Backups from older versions upgrade automatically.
- Data check - Finds and fixes problems such as transfers missing their other side.
- Optional password - Off by default; set one in Settings › Security.
- AI agents - Optionally let an AI assistant such as Claude read and update your data over MCP or an HTTP API, with access keys you control.
- Works like an app on your phone - A tab bar with adding a transaction one tap away, Back that closes what's open, and it installs to your home screen (see below).
Dashboard with a forecast and likely range · Bills and pay day on a calendar
Money flow by category · Transactions grouped by day
On your phone, installed from the browser · all screenshots use demo data
Brisk Budget can be installed on your phone, tablet or computer, so it opens from its own icon in its own window, without the browser around it. It keeps a copy of the app itself (never your data) on the device, so it opens straight away, and if your server can't be reached it says so instead of showing an error page. After an update it offers to reload.
- Android, or Chrome and Edge on a computer: Settings › About & updates › Install app, or Install app in the browser's menu. A long press on the installed icon offers Add transaction and Recurring.
- iPhone and iPad: tap Share, then Add to Home Screen.
Browsers only install apps from a secure address, so reach Brisk Budget over HTTPS (for example through a reverse proxy with a certificate) or at localhost. Add to Home Screen on an iPhone or iPad works over plain HTTP too, without the offline copy.
All data is stored as plain JSON files in the data/ folder, created on first run. No external database is required. Account icons are stored as image files in data/icons/.
Backups are kept in backups/: the last 24 hourly backups, plus safety copies taken before every upgrade and restore.
Most settings live in the app (Settings › General): your name, currency symbol and chart grouping.
These environment variables are optional. If you installed with the install command, put them in /etc/default/brisk-budget (one NAME=value per line), then run sudo systemctl restart brisk-budget:
| Variable | Default | Purpose |
|---|---|---|
PORT |
3000 |
Port to listen on |
HOST |
all interfaces | Address to listen on, e.g. 127.0.0.1 behind a reverse proxy |
BRISK_DATA_DIR |
./data |
Where data is stored |
BRISK_BACKUPS_DIR |
./backups |
Where backups are stored |
BRISK_TRUST_PROXY |
off | Set to 1 behind a reverse proxy, so sign-in limits apply per visitor |
BRISK_ALLOWED_HOSTS |
none | Extra web addresses Brisk Budget answers to without a password, e.g. budget.example.com, *.home.example.com (see Security) |
BRISK_OPEN_WITHOUT_PASSWORD |
off | Set to 1 to answer devices outside your own network while no password is set (not recommended; see Security) |
TZ |
the server's | Time zone for "today", e.g. Europe/London. Worth setting if your server runs on UTC |
BRISK_UPDATE_CHECK |
on | Set to 0 to never contact GitHub for update checks |
Without a password, anyone who can reach Brisk Budget on your network can use it. Set a password in Settings › Security if other people share your network, and put Brisk Budget behind HTTPS (for example a reverse proxy) before exposing it to the internet.
Until a password is set, Brisk Budget only answers devices on your own network: your home or office network, a VPN such as Tailscale, or a reverse proxy on one of those. So a server that can be reached from the internet can't be read, or have a password set on it by someone else, before you set one. To set one on a server you can't reach locally, use an SSH tunnel (ssh -L 3000:localhost:3000 your-server, then open http://localhost:3000).
Without a password, Brisk Budget only answers to its IP address, localhost and local network names (such as raspberrypi, budget.local, nas.lan or *.home.arpa). This stops other websites from reaching it through your browser. If you open it by your own domain name, including through a reverse proxy, either set a password or add the name to BRISK_ALLOWED_HOSTS.
Forgotten your password? Delete data/auth.json on the server and restart Brisk Budget.
Brisk Budget can let an AI assistant work with your data for you: for example, Claude reading your bank statements and adding them to the right accounts. It is off unless you turn it on in Settings › AI agents, where you also create access keys (full access or read only), revoke them, and see what agents have changed.
The same tools are offered two ways, with the same names and arguments:
- MCP at
/mcp(Streamable HTTP), for Claude, Claude Code and other MCP apps. For Claude Code:claude mcp add --transport http brisk-budget http://your-server:3000/mcp --header "Authorization: Bearer <key>" - HTTP API:
GET /api/agentlists the tools;POST /api/agent/tools/<name>runs one with its arguments as JSON. Send the key asAuthorization: Bearer <key>. The key also works on every other API endpoint.
Agents can change anything you can in the app, except signing in, the password, AI access itself, deleting backups and uploading a backup to restore (they can restore a saved one, which keeps a safety copy first), so whatever an agent does can be undone. Treat a full-access key like a password, and use HTTPS if agents reach Brisk Budget over the internet.
npm install
npm run dev # restarts on server changes
npm test # server and logic tests
npx playwright install chromium
npm run test:e2e # browser tests (they use their own demo data)
node scripts/seed-demo.js /tmp/brisk-demo/data # a demo household to try things with
BRISK_DATA_DIR=/tmp/brisk-demo/data npm start- Backend: Node.js native HTTP module
- Frontend: Vanilla JavaScript modules and CSS, no build step
- Storage: File-based JSON
- Dependencies: One (adm-zip)
Simply, I couldn't find a good alternative to Microsoft Money. Everything was either a paid subscription, missing key features or had terrible UX for the average person. I wanted something simple, self-hosted and easy to use.
This project was coded with LLM assistance. I provided the concepts, architecture, UX/UI design, and branding. AI wrote the code iteratively as I tested each component. I'm a designer, not a full-stack developer but I'm learning as I go.
From version 0.4.5, Brisk Budget is source-available under the Functional Source License, Version 1.1, MIT Future License (FSL-1.1-MIT). You can use, copy, change and run it for any purpose, including in your own business, except to offer a product or service that competes with Brisk Budget. Two years after each version is released, that version also becomes available under the MIT licence.
Versions up to and including 0.4.4 were released under the MIT licence and stay that way.
Ethan Copping
