Skip to main content
Open source · Self-hosted · MIT

Your bank statements, turned into clean financial data

Lumio imports statements and receipts, deduplicates and categorizes every transaction, and builds dashboards, budgets, VAT returns and income tax drafts on top — on your own server.

Lumio dashboard overview with income, spending, savings rate and top categories

What Lumio does

One place for the whole path from a raw bank export to numbers you can budget, report and file taxes with.

Statement import

PDF, CSV, XLSX, DOCX and image files. Native parsers for Kaspi, Bereke and Bank Hapoalim / Isracard, OCR for scans, and a generic AI parser for any other bank. SHA-256 hashing stops duplicate uploads.

Clean, categorized data

Fingerprint-based deduplication, categorization rules that learn from your corrections, and AI categorization through any OpenAI-compatible endpoint, including a local one.

Dashboards and reports

Cash flow, trends, top categories and merchants, a data health view, and custom reports with CSV and XLSX export.

Budgets, goals and net worth

Budgets with live spend, savings goals, subscription detection, a crypto portfolio, net worth across accounts, and advice generated from your own numbers.

VAT and income tax

A VAT engine with returns, plus year-end income tax drafts: Germany Anlage EÜR, Spain Modelo 100, Poland PIT-36L / PIT-28 / PIT-36, and a generic summary elsewhere. Filing deadlines for 25 EU countries.

Receipts on a map

Collect receipts by upload or from an IMAP inbox, link them to transactions, and see where each one was bought on self-hosted map tiles.

Workspaces, roles and audit

Multi-tenant workspaces with owner, admin, member and viewer roles, an audit log with rollback, TOTP two-factor sign-in and session management.

Integrations and API

S3-compatible and WebDAV storage, Telegram reports, webhooks, API keys and an MCP server.

Self-hosted by design

One Docker Compose stack, encrypted backups, Prometheus-format metrics, structured JSON logs, and a UI in 21 languages. MIT licensed.

A closer look

Lumio trends screen
Trends — Twelve months of income and expenses with period presets.
Lumio statements screen
Statements — Work queue, spend analytics and category drill-down.
Lumio tax declaration screen
Tax declaration — An Anlage EÜR draft with data completeness and filing dates.
Lumio budgets screen
Budgets — Monthly and annual budgets tracked against real spend.
Lumio advice screen
Advice — Observations about savings, prices and reconciliation.

Tech stack

A TypeScript monorepo: NestJS API, Next.js web app, PostgreSQL and Redis, all run with Docker Compose.

NestJS 11Next.js 16React 19TypeScriptPostgreSQL 14Redis 7TypeORMBullMQSocket.IODocker Compose

Ready to try Lumio?

The quick start brings up the full stack with Docker in a few minutes. Contributors can start with the architecture overview.