ledger-01
Health Uyari
- License — License: Apache-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Basarisiz
- exec() — Shell command execution in apps/web/docs-shots/screens.spec.ts
- process.env — Environment variable access in apps/web/e2e/connect.spec.ts
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Ledger/01: A self-hostable personal and household finance app.
Ledger/01
A self-hostable personal and household finance app.
Track every wallet, in any currency, on every device, on a server you own.
It costs close to nothing to run.
Contents
- Why Ledger/01
- Everything a household ledger needs
- Up and running in five minutes
- Your bank statements, without the typing
- Ask your AI about your money
- Host it yourself on AWS
- Serverless, so it costs cents
- Open source, open contract
- Contributing
- Security and license
Why Ledger/01
|
You own your data It runs in your AWS account, against your database. Download the whole ledger as one file whenever you like. Your data → |
One ledger, every device Install it on your phone and laptop, and share one household with the people you allow. Features → |
|
Drop in a statement, done Drag your bank's CSV or Excel file onto the page. Duplicates, discounts and refunds are sorted out for you. Importing → |
Costs cents a month Everything scales to zero. A household's usage fits in AWS's and Neon's free tiers. Costs → |
|
Ask your AI Connect Claude and ask "am I spending more on takeout than last month?". It can read, never change. AI assistants → |
Open and transparent MIT or Apache-2.0. Every line, every API call and every release note is public. Development → |
Everything a household ledger needs
Wallets in any currency, with categories, labels and notes on every transaction. Transfers between
currencies, where you type any two of sent, received and rate. Dashboards, budgets, and recurring
bills that show up in a Future view without touching today's balance.
Read more: the features tour →
Up and running in five minutes
Four commands start Postgres, the API and the web app on your machine, and a dev-only login skips
the Google setup. The guide then walks you through your first wallet, transaction, import and
budget.
Your bank statements, without the typing
Import CSV, XLSX and XLS statements with column mapping and duplicate detection. Discounts and refunds
are matched to the purchases they belong to. Backups restore on any instance, and CSV export opens
straight in a spreadsheet.
Read more: import, backup and export →
Ask your AI about your money
Ledger/01 is an MCP server. Add it to Claude as a connector, sign in, and ask questions about your own
numbers. Access is read-only, and you can disconnect it from Settings at any time.
Host it yourself on AWS
One GitHub Actions workflow deploys the whole app to your own AWS account with SST. There are no
long-lived keys: the workflow signs in to AWS with GitHub's OIDC, and your secrets stay in your
repository's production environment.
Serverless, so it costs cents
The Go API and the Next.js app run on Lambda behind CloudFront, and Postgres runs on Neon, which
scales to zero. With nothing running, nothing is billed. A typical household's month comes to about
ten cents.
Read more: architecture and costs →
Open source, open contract
A Go API on Connect-RPC, a Next.js web app, and one protobuf contract that generates both clients.
Run task test for integration tests against a real Postgres, and Playwright for end-to-end tests.
Every release follows semantic versioning.
Read more: local development →
Contributing
Bug reports, fixes and new banks are all welcome. Adding your bank is one small Go file and a test.
Security and license
Report security issues privately as described in SECURITY.md.
Dual-licensed under either of MIT or Apache-2.0, at your option.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi