Skip to content

About

A Light Weight, JSON Based, Personal Finance Tracker

Resources

Stars

25 stars

Watchers

1 watching

Forks

Repository files navigation

Brisk Budget

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

Brisk Budget on a laptop, a monitor, a tablet and a phone

A lightweight, self-hosted personal finance tracker for household finances. No subscriptions, no cloud, no database: just your money, on your server.

Quick Deploy (Ubuntu / Debian)

Install with a single command:

curl -fsSL https://raw.githubusercontent.com/CoppingEthan/Brisk-Budget/main/deploy.sh | sudo bash

The 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.

Updating

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-budget are never touched

Automatic updates

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-update

Turn 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.

Manual Deploy

  1. Clone the repository
  2. Install dependencies: npm install --omit=dev
  3. Start the server: npm start
  4. Open your browser to http://localhost:3000

Requires Node.js 20 or newer.

Features

  • 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).

A look around

Dashboard: net worth, cash, savings and debt, with a year of history and a year's forecast Recurring: monthly income and outgoings, and a calendar of what's due
Dashboard with a forecast and likely range · Bills and pay day on a calendar

Money flow: income on one side, spending by category on the other An account's transactions, grouped by day with running balances
Money flow by category · Transactions grouped by day

On a phone: the dashboard, an account and the bills calendar, with the tab bar along the bottom
On your phone, installed from the browser · all screenshots use demo data

Install it as an app

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.

Data Storage

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.

Configuration

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

Security

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.

AI Agents (MCP and API)

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/agent lists the tools; POST /api/agent/tools/<name> runs one with its arguments as JSON. Send the key as Authorization: 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.

Development

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

Tech Stack

  • Backend: Node.js native HTTP module
  • Frontend: Vanilla JavaScript modules and CSS, no build step
  • Storage: File-based JSON
  • Dependencies: One (adm-zip)

Why I Built This

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.

Development & AI Usage

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.

License

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.

Author

Ethan Copping

About

A Light Weight, JSON Based, Personal Finance Tracker

Resources

Stars

25 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages