tombadilo-bombadilo/budgero has 58 GitHub stars and 8 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-17 00:42 UTC. Last push 2026-11-13.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Local-first, self-hostable, end-to-end encrypted ZBB app
Self-hostedREADME.md
OriginalBudgero
Budgero is a local-first personal budgeting application: envelope-style budgets, transaction tracking, goals, recurring payments, rules, multi-currency support, and financial analytics. Data lives in SQLite on the client (browser, via WASM) and syncs end-to-end encrypted through a Go backend.
This is Budgero's primary repository. Development, reviews, and merges happen here, and issues and pull requests are welcome — see CONTRIBUTING.md.
Releases
Find version notes and downloads on GitHub Releases. Maintainers: see the release procedure.
License
Budgero is open source under the
GNU Affero General Public License, version 3 (AGPL-3.0-only), an
OSI-approved license:
- You may use, study, modify, self-host, and redistribute the software — including commercially.
- If you offer a modified version to others over a network, you must make your modified source available to them under the same license.
The Python SDK (packages/sdk-python) is separately licensed under MIT so that
client applications embedding it are not affected by the AGPL. Releases prior to
the relicense were published under FSL-1.1-ALv2.
Repository layout
| Package | Description |
|---|---|
packages/app |
React frontend (Vite, TailwindCSS, PWA) |
packages/core |
Shared TypeScript domain logic: SQLite schema, migrations, services |
packages/runtime |
Local-first runtime: sync transport, mutation execution, encryption |
packages/server |
Go API server (Echo, SQLite) |
packages/website |
Marketing and documentation site (Next.js) |
packages/sdk-python |
Python SDK for the Push API |
packages/eslint-config |
Shared ESLint configuration |
Each package has its own README with details.
Builds
Budgero ships in exactly two flavors:
- Cloud (SaaS) — the hosted service at budgero.app, built
with
app.Dockerfile(Clerk authentication, subscriptions). - Self-host — a single binary with the frontend embedded, or a Docker image built
with
selfhost.Dockerfile(local authentication, no cloud dependencies). See docs/selfhost-cli.md.
Development setup
Prerequisites: Node.js 22+, pnpm 11+, Go 1.26+.
pnpm install
pnpm run setup:dev # one-time setup (package builds, Air for Go hot-reload)
pnpm run dev:selfhost # frontend + Go backend in self-host mode
pnpm run dev:website # marketing site (port 3000)
The app is served at http://localhost:5173, the API at http://localhost:3001.
Self-host mode is the flavor that works out of the box. The cloud (SaaS) flavor
(pnpm run dev:cloud) requires a Clerk development instance of your own —
set VITE_CLERK_PUBLISHABLE_KEY in packages/app/.env.local.
Quality gates
pnpm run type-check:all # tsc across core, runtime, app
pnpm run lint:app # eslint (also :core, :runtime, :server)
pnpm run test:core # domain logic tests (also test:app, test:server)
pnpm run build:all # full production build
pnpm run security # osv-scanner + govulncheck
Documentation
| Document | Topic |
|---|---|
| docs/selfhost-cli.md | Self-host CLI reference |
| docs/build-flags.md | Build and runtime flags |
| docs/STYLEGUIDE.md | Code conventions |
| docs/data-format-versioning.md | Sync wire-format versioning |
Support
- Bug reports: GitHub issues
- Security vulnerabilities: see SECURITY.md
- Website: budgero.app
- Email: [email protected]
Supporting the project
Self-hosting Budgero is free, with the full feature set, and always will be. If it saves you money, you can donate — pay what you want — or simply star this repository. Both genuinely help.