LibreFolio

Free to understand, free to act.
A self-hosted, open-source financial portfolio tracker.

---

Bring all your investments into one private, secure dashboard. Track stocks, ETFs, crypto, bonds, and loans across multiple brokers — with automated pricing, FX conversion, and technical analysis tools.

Your data stays on your server. No third-party cloud. No tracking.

📚 Full Documentation: https://alfystar.github.io/LibreFolio/

🚀 Quick Start

Local Development (Pipenv)

Prerequisites: Python 3.13+, Pipenv, Node.js 20.19+

git clone https://github.com/Alfystar/LibreFolio.git
cd LibreFolio

pipenv install --dev
pipenv shell

./dev.py install        # Install all dependencies (backend + frontend)
cp .env.example .env    # Configure environment
./dev.py db upgrade     # Run database migrations
./dev.py server         # Start development server

Access: http://localhost:8000 — API Docs: http://localhost:8000/api/v1/docs

./dev.py --help shows all available commands.

For full setup details see the Developer Installation Guide.

Docker Deployment

git clone https://github.com/Alfystar/LibreFolio.git
cd LibreFolio

cp .env.example .env       # Configure environment
./dev.py docker build      # Build image (auto-builds frontend + docs)
docker compose up -d       # Start container

Access: http://localhost:8000 — The first registered user becomes administrator.

For reverse proxy, test mode, and advanced options see the Docker Guide.

🤝 Contribute

LibreFolio values every form of contribution equally — code, ideas, and donations all drive the project forward.

💡 High-Impact Contributions

• New Plugins — LibreFolio uses a Registry & Plugin System with three plugin types:
  • 📥 BRIM Plugins — Import from a new broker (CSV/Excel)
  • 📈 Asset Plugins — Fetch prices from a new data source
  • 💱 FX Plugins — Add a new exchange rate provider
• Chart Signal Plugins — New technical indicators and chart overlays
• UI/UX Ideas — Aesthetic improvements and design suggestions
• Bug Reports — Finding and reporting issues on GitHub Issues

🛠️ How to Contribute Code

1. Fork the repository
2. Create a branch for your feature or fix
3. Submit a Pull Request with a clear description

See the Developer Manual for architecture, conventions, and testing guidelines.

📄 License

LibreFolio is licensed under GNU Affero General Public License v3.0 (AGPL-3.0). You can use, modify, and distribute it freely — if you distribute modifications (including over a network), you must release your source under AGPL-3.0.

See LICENSE for the full text and the Credits & Legal page for details.

---

If LibreFolio helps you manage your investments, consider supporting its development:



⭐ Star on GitHub · 💡 Share Ideas · 🐛 Report Bugs