v1.0.0-beta.1

PERSONAL FINANCE. ON YOUR TERMS.

Your money.
Your system.

A clear home for your accounts, spending and plans. Built for Bangladesh, where a bank API isn’t always an option.

Self-hosted · BDT-first · MIT licensed

YOUR FINANCIAL WORKSPACE

FROM A MESSAGE TO A CLEARER PICTURE

Bring the pieces together.

Your collector does the intake.
You stay in control of the ledger.

  1. 01
    Collect

    Bank emails, SMS or a CSV statement

  2. 02
    Review

    Check amounts, accounts and duplicates

  3. 03
    Record

    One deliberate entry. A traceable history.

Your server. Your PostgreSQL database.

Exact amounts. Integer poisha, clear BDT balances.

Open by design. REST, MCP and readable docs.

LESS FRICTION. MORE UNDERSTANDING.

The everyday essentials,
connected.

Track manually today. Connect your own tools when you’re ready. Every financial change follows the same shared rules.

01 / THE FULL PICTURE

Accounts & net worth

Eleven manual account types, including bank accounts, mobile wallets, property, loans and credit cards. Dated valuations keep income and spending separate.

Understand your accounts
02 / THE EVERYDAY DETAILS

Transactions & plans

Categories, tags, splits, monthly budgets and recurring schedules. Match movements between your accounts without counting them as spending.

Explore the ledger
03 / A SECOND PAIR OF EYES

Statements & rules

Map CSV columns, preview rows, review possible duplicates and compare closing balances. Preview classification rules before applying changes.

Bring in a statement

BUILT AROUND BANGLADESH

No bank API?
Start with what you receive.

Use your own n8n workflow or agent to turn bank emails and SMS into drafts. Budget Go provides the review inbox, Bangla-digit support, duplicate checks and deliberate posting.

Read the automation guide
ONE WORKSPACE. YOUR TOOLS.API + MCP
GET/api/v4/workspace
Read accounts and the ledger
POST/api/v3/ingest
Stage a bank-alert draft for review
MCP/api/mcp
Connect a client with a scoped token
API reference

A HOME ON YOUR OWN SERVER

Two ways to Docker.

Choose the database setup that fits your server. Versioned images are published to GitHub Container Registry.

OPTION 01 RECOMMENDED TO START

Bring the whole stack

Compose runs Budget Go and PostgreSQL together. A named volume keeps your database across container updates.

compose.yamlInstall with PostgreSQL
OPTION 02

Use your own database

Run the app container against an existing PostgreSQL server. Supply your connection URL and keep database operations in your own setup.

compose.external.yamlUse external PostgreSQL
Pull a specific releaseContainer packages
docker pull ghcr.io/creativekamrul/budget-go:1.0.0-beta.1

Back up your database, review release notes, then pull and migrate before restarting. Read the upgrade guide →

BETA, WITH CLEAR BOUNDARIES

A working foundation.
An open roadmap.

This beta supports manual BDT finance and reviewed imports. Live bank connections, FX, investment market prices and household sharing are not included. External collectors need your own setup.

This website is the project’s static documentation site. The private finance application runs on your own server.

See feature coverage and limits

MAKE IT YOURS

A clearer financial picture
starts with one place.

Read the installation guide