Lumina-Finance

Lumina-Finance / lumina-finance

Public

A feature rich, self hostable alternative for managing your personal finances

19
0
85% credibility
Found May 22, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Lumina Finance is a self-hosted personal finance application that helps you track accounts, transactions, budgets, and financial trends while keeping your data under your control. It provides a dashboard showing net worth, credit usage, spending, and savings rate, along with detailed insights about cash flow, income versus expenses, and spending patterns by merchant. You can create budgets for specific spending categories, track tax-advantaged retirement accounts, and calculate your financial runway—how long your savings would last based on average spending. The app runs entirely on your own infrastructure using Docker or bare metal, with no cloud dependency or subscription required.

How It Works

1
💡 You discover Lumina Finance

You hear about a privacy-focused finance app you can run on your own computer, keeping all your money data under your control.

2
🚀 You set up your own instance

With one click or a simple command, you launch the app on your own server or computer—no cloud services, no subscriptions.

3
👤 You create your account

You sign up with your email, choose a password, and pick your home currency and timezone. Everything is secured with your own private keys.

4
🏦 You add your bank accounts

You enter your checking, savings, credit cards, and loans. Lumina remembers your balances and tracks them over time.

5
💸 You record your spending

Each purchase gets categorized—groceries, dining out, subscriptions. You can add them one by one or import from a spreadsheet.

6
You explore your finances
📈
Track your net worth

Watch your assets grow and debts shrink over time with beautiful charts.

🎯
Set spending budgets

Create monthly limits for categories like dining or shopping, and see how you're doing.

✈️
Calculate your runway

See how many months your savings would last if income stopped.

🎉 You understand your money

With all your accounts, transactions, and insights in one private place, you finally see the full picture of your finances.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is lumina-finance?

Lumina Finance is a self-hosted personal finance app for tracking accounts, transactions, budgets, and financial trends. It gives you a dashboard showing net worth, credit usage, spending breakdowns, and savings rate, plus an insights tab with cash flow analysis, income/expense reports, and merchant patterns. The backend runs on Python with FastAPI and PostgreSQL, while the frontend is a React app served as static files. You deploy it with Docker or bare metal, keeping all your data under your own control.

Why is it gaining traction?

The main hook is privacy and control. Unlike Mint or YNAB, your data never leaves your server. The feature set is surprisingly deep for an early project: tax-advantaged account tracking (IRA, 401k, TFSA limits), group sharing with granular permissions, runway calculations showing how long your cash cushion lasts, and balance history charts. The JWT auth with RS256 key pairs and a JWKS endpoint is a nice touch for developers who want to proxy it behind an API gateway. It fills the gap between simplistic trackers and bloated enterprise tools.

Who should use this?

Privacy-conscious individuals who want full ownership of their financial data. Couples or families sharing expenses might benefit from the group features with per-member permissions. Developers comfortable with self-hosting who want a modern alternative to Firefly III or actualbudget. Not ready for teams or businesses yet (license explicitly prohibits commercial use), and the lack of automatic bank syncing means manual transaction entry for now.

Verdict

With a 0.85% credibility score and only 19 stars, this is a promising but immature project. The codebase shows solid engineering (async Python, proper auth patterns, well-structured API), but the missing bank connections and UI polish are real gaps. Worth watching if you need self-hosted finance tracking now, but check the roadmap before betting on it for critical use cases.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.