Skip to content

albilu/open-finance

Repository files navigation

Open-Finance — NG Personal Finance Manager

Local-first, privacy-focused personal finance application.
Consolidates your assets, liabilities, and transactions in one secured dashboard.

Open Finance Dashboard

Backend CI Frontend CI Publish Docker Image Release License: ELv2


Quick Start — Docker (Recommended)

Requires Docker and Docker Compose.

git clone https://github.com/open-finance/open-finance.git
cd open-finance

cp .env.example .env

docker compose up -d
# Open http://localhost:3000

Bug reports and feature requests → GitHub Issues


Deployment Options

Self-Hosted Cloud
Cost Free Subscription
Setup Docker Compose None
Data location Your machine Managed hosting
Updates Manual Automatic

Development

The recommended setup uses the pre-configured DevContainer — includes Java 21, Maven, Node.js, SQLite, and all VS Code extensions, with zero manual installation.

Requirements: Docker + VS Code + Dev Containers extension

git clone https://github.com/open-finance/open-finance.git
code open-finance
# F1 → "Dev Containers: Reopen in Container"

mvn spring-boot:run   # Backend
npm run dev           # Frontend

# Backend (from repo root)
mvn test
mvn clean test jacoco:report   # with coverage

# Frontend (from openfinance-ui/)
npm test
npm run type-check && npm run lint

See CONTRIBUTING.md for architecture, API reference, coding standards, and how to submit changes.
See docs/SECURITY.md for encryption, authentication, and responsible disclosure.


PFA Landscape

Feature Open-Finance Finary Maybe/Sure Wealthfolio GnuCash HomeBank MMEX KMyMoney Skrooge
Modern Interface ⚠️ ⚠️ ⚠️ ⚠️ ⚠️
Basic Finance Mgmt ⚠️
Rich Dashboards ⚠️ ⚠️ ⚠️ ⚠️
QIF/OFX Import ⚠️ ⚠️
Real Estate Mgmt ⚠️ ⚠️ ⚠️ ⚠️
File Attachments ⚠️
Auto Categorization ⚠️ ⚠️ ⚠️ ⚠️ ⚠️
Undo/Redo/Backup ⚠️ ⚠️ ⚠️ ⚠️ ⚠️
Financial Planning ⚠️ ⚠️ ⚠️ ⚠️ ⚠️
Financial News
Multi-Currency
AI Assistant
Data Security/Privacy ⚠️
FOSS
Multilingual (EN/FR)

✅ Full support · ⚠️ Partial · ❌ Not supported

Full feature User Guide → Wiki


License

Elastic License v2 (ELv2) — free to self-host and modify.
Offering this software as a managed/hosted service to third parties requires a commercial license.