Skip to main content

A command line investment assistant to organize your portfolio and simulate its future to reach your life goals.

Project description


Finalynx Assistant

View in English 🇬🇧 / Lire en Français 🇫🇷

Minimalistic command-line tool to help you manage your investments

PyPI GitHub Workflow Status (main) License GitHub Sponsors Mentioned in Awesome Finary

Built with ❤︎ by Pierre Laclau and contributors. Logo generated by Midjourney.


Finalynx is your "Finary Assistant", a command-line (and experimental web dashboard) tool to organize your investments portfolio and get automated monthly investment recommendations based on your future life goals. This tool synchronizes with your Finary account to show real-time investment values.

Don't have Finary yet? You can sign up using my referral link 🌹 (or through the default page).

[Click] Additional screenshots 📸
Recommendations Web dashboard

Finalynx also includes a daily budget manager to classify your expenses and show monthly & yearly statistics:

Statistics and visualizations will be added soon!

✨ Features

  1. ✅ Portfolio: Organize your assets, set targets, and sync with your Finary account.
  2. ✅ Assistant: Get monthly recommendations on where to invest next to meet your goals.
  3. ✅ Simulator: Define your life goals and events, simulate your portfolio's future.
  4. ⏳ Web dashboard: Generate global statistics and graphs to understand each line and folder.
  5. 🙏 Extensions: Make this tool work for other people's situations, contributions needed 👀

You can check the current development status. Contributions are warmly welcome!

🚀 Installation

If you don't plan on touching the code, simply run (with python >=3.10 and pip installed):

pip install finalynx  # run again with --upgrade to update

And you're done! Now create your own copy of the demo.py example anywhere and run it to make sure everything works. You can now customize it for your own needs 🚀

Pro Tip 💡: Why not setup a script to autorun your config in a new terminal on startup? Could be a nice view 🤭

⚙️ Usage & Documentation

The goal is to declare a tree structure of your entire portfolio independently from their host envelopes (e.g. PEA, AV, CTO, etc). Once your entire portfolio strategy is defined here, find the best envelope for each line and add them to your Finary account (manual or automatic sync). Finalynx will fetch each line and display your full portfolio with real-time amounts.

Here is the bare minimum code accepted:

from finalynx import Portfolio, Assistant
portfolio = Portfolio()     # <- your custom configuration here
Assistant(portfolio).run()  # <- see tutorials for more options

You can now populate the Portfolio class with your own custom hierarchy by taking inspiration from the demo.py example or by reading the Getting Started guide in the documentation and step-by-step Tutorials. For additional details, checkout the full API Reference or ask a question.

Once you have a fully defined portfolio tree with sensible targets, you can display how much you need to invest in each line using:

python your_config.py delta  # type --help for other options, like launching a web dashboard!

👨‍💻 Feedback & Contributions

This repository is at a very early stage. Unfortunately, I won't have time to make this tool work for everyone by default, but you are welcome to extend this project (or hire me if you can't develop it yourself). Pull requests, issues (🇬🇧 preferably) and open discussions (🇬🇧/🇫🇷) are warmly welcome!

If you would like to contribute to this project, welcome on board and thanks for your interest! 🎉 Please read the contribution guidelines to setup the project on your machine and agree on common conventions.

📄 License

This project is under the GPLv3 License meaning anyone can use, share, extend, and contribute to this project as long as their changes are integrated to this repo or also published using GPLv3. Please contact me for any specific licensing requests.

💌 Donations

This is a personal project I have fun with on my free time. If you found it useful and wish to support my work, you can buy me a coffee! It would give me the motivation to keep improving it further 😄 Thank you!

Also, big thanks to all contributors 🌹 don't forget to check them out:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

finalynx-1.23.0.tar.gz (79.8 kB view details)

Uploaded Source

Built Distribution

finalynx-1.23.0-py3-none-any.whl (100.1 kB view details)

Uploaded Python 3

File details

Details for the file finalynx-1.23.0.tar.gz.

File metadata

  • Download URL: finalynx-1.23.0.tar.gz
  • Upload date:
  • Size: 79.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.1 CPython/3.10.12 Linux/6.2.0-39-generic

File hashes

Hashes for finalynx-1.23.0.tar.gz
Algorithm Hash digest
SHA256 9bda31c066191a465d58d679a60c913e2a81c76b5ae3ab4c079c92b54b0908a7
MD5 954ee3a3ce05df5d1690a1673b6841b3
BLAKE2b-256 2344cc36a6d0e9b7cac5731f4920b8d4144b6cfc554a2b7cb88eae7f4c07b46a

See more details on using hashes here.

File details

Details for the file finalynx-1.23.0-py3-none-any.whl.

File metadata

  • Download URL: finalynx-1.23.0-py3-none-any.whl
  • Upload date:
  • Size: 100.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.1 CPython/3.10.12 Linux/6.2.0-39-generic

File hashes

Hashes for finalynx-1.23.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7585a4f865f35f33e1287791d18a50e848d789e38c407b590231bdfafc7e7994
MD5 dca1f3d6f274fa798e64ec471947b145
BLAKE2b-256 c2487efeacf49a3da126366d4ecd4c28b65f4fb423f601e08f85b8738806c922

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page