Skip to content

iguit0/securo

 
 

Securo logo

Securo

CI Coverage License: AGPL-3.0
Website · Docs · Roadmap

Finance apps want your data. This one doesn't.

We believe personal finance should actually be personal. No corporation should sit between you and your financial data. Securo is an open-source finance manager that runs on your own infrastructure, giving you full visibility into your accounts, spending, and habits, without surrendering a single byte to third parties. Take back control.

Quick Start

Linux & macOS (installs Docker if needed):

curl -fsSL https://usesecuro.com/install.sh | bash

Windows: Install Docker Desktop, then:

git clone https://github.com/securo-finance/securo.git && cd securo
docker compose up --build

Open http://localhost:3000 and create an account. That's it.

Securo dashboard

Features

  • Multi-account management with running balances
  • Transaction management with search, filters, and CSV export
  • File import (OFX, QIF, CAMT, CSV)
  • Auto-categorization rules engine
  • Recurring transactions and budgets
  • Goals and savings targets with progress tracking
  • Asset management with valuation tracking and growth rules
  • Reports: Net Worth and Income vs Expenses with category sparklines
  • Dashboard with spending analytics and projections
  • Bank sync via providers (Pluggy supported, extensible)
  • Multi-currency support with automatic FX conversion
  • Multi-user support with admin panel and registration controls
  • Two-factor authentication (TOTP) with brute-force protection
  • Dark/light theme, multi-language support, privacy mode

Bank Sync (Optional)

Create a .env file with your Pluggy credentials:

PLUGGY_CLIENT_ID=your-client-id
PLUGGY_CLIENT_SECRET=your-client-secret

Then restart: docker compose up

Exchange Rates (Optional)

For automatic currency conversion, add a free Open Exchange Rates key to .env:

OPENEXCHANGERATES_APP_ID=your-app-id

Rates are fetched on-demand when foreign-currency transactions are created. Without a key, cross-currency amounts default to a 1:1 fallback rate with a visual warning.

Tech Stack

Layer Stack
Backend FastAPI, SQLAlchemy, Alembic, Celery
Frontend React, TypeScript, Vite, Tailwind CSS
Database PostgreSQL
Queue Redis + Celery

AI-Assisted Development

Parts of this codebase were built with help of AI. All code is human-reviewed and no data leaves your environment.

Development

# Run backend tests
docker compose exec backend pytest

# Rebuild after dependency changes
docker compose up --build

Contributing

See CONTRIBUTING.md for guidelines.

License

This project is licensed under the GNU Affero General Public License v3.0.

This means you can freely use, modify, and distribute this software, but any modifications — including when used as a network service (SaaS) — must also be released under the AGPL-3.0.

About

Open-source personal finance manager. Self-hosted, privacy-first.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 63.8%
  • TypeScript 35.5%
  • Shell 0.4%
  • CSS 0.2%
  • JavaScript 0.1%
  • HTML 0.0%