{"id":13755744,"url":"https://github.com/MadeInPierre/finalynx","last_synced_at":"2025-05-10T02:32:58.188Z","repository":{"id":65964054,"uuid":"588101350","full_name":"MadeInPierre/finalynx","owner":"MadeInPierre","description":"A minimalistic companion (CLI \u0026 web) to organize your investment portfolio, simulate its future, and reach your life goals.","archived":false,"fork":false,"pushed_at":"2025-03-15T16:49:16.000Z","size":5187,"stargazers_count":71,"open_issues_count":4,"forks_count":13,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-02T09:53:54.655Z","etag":null,"topics":["cli","command-line","command-line-tool","dashboard","finance","finary","invest","investing","investment","optimization","portfolio","python","simulation","web"],"latest_commit_sha":null,"homepage":"https://finalynx.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MadeInPierre.png","metadata":{"files":{"readme":"README.fr.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"MadeInPierre","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2023-01-12T10:27:29.000Z","updated_at":"2025-04-19T09:23:54.000Z","dependencies_parsed_at":"2024-02-08T18:40:48.109Z","dependency_job_id":"6da7ade7-b86e-4570-8175-30482129532e","html_url":"https://github.com/MadeInPierre/finalynx","commit_stats":null,"previous_names":["madeinpierre/finary_assistant"],"tags_count":71,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MadeInPierre%2Ffinalynx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MadeInPierre%2Ffinalynx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MadeInPierre%2Ffinalynx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MadeInPierre%2Ffinalynx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MadeInPierre","download_url":"https://codeload.github.com/MadeInPierre/finalynx/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253354489,"owners_count":21895436,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","command-line-tool","dashboard","finance","finary","invest","investing","investment","optimization","portfolio","python","simulation","web"],"created_at":"2024-08-03T11:00:27.396Z","updated_at":"2025-05-10T02:32:57.704Z","avatar_url":"https://github.com/MadeInPierre.png","language":"Python","readme":"\u003ch1 align=\"center\"\u003e\n  \u003ca href=\"https://github.com/MadeInPierre/finalynx\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/MadeInPierre/finalynx/main/docs/_static/logo_assistant_transparent.png\" width=\"400\" /\u003e\n  \u003c/a\u003e\n  \u003cbr\u003eFinalynx Assistant\u003cbr\u003e\n\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n  View in \u003ca href=\"https://github.com/MadeInPierre/finalynx/blob/main/README.md\"\u003eEnglish 🇬🇧\u003c/a\u003e / Lire en \u003ca href=\"https://github.com/MadeInPierre/finalynx/blob/main/README.fr.md\"\u003eFrançais 🇫🇷\u003c/a\u003e\n\n  \u003cbr\u003e\n\n  \u003ch4\u003eOutil de ligne de commande minimaliste pour vous aider à gérer vos investissements\u003c/h4\u003e\n  \u003ca href=\"https://pypi.org/project/finalynx/\"\u003e\u003cimg alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/finalynx?style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/MadeInPierre/finalynx/actions/workflows/semantic-release.yml\"\u003e\u003cimg alt=\"GitHub Workflow Status (main)\" src=\"https://img.shields.io/github/actions/workflow/status/madeinpierre/finalynx/semantic-release.yml?branch=main\u0026style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/MadeInPierre/finalynx/blob/main/LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/madeinpierre/finalynx?style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sponsors/MadeInPierre\"\u003e\u003cimg alt=\"GitHub Sponsors\" src=\"https://img.shields.io/github/sponsors/MadeInPierre?style=flat-square\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/finary-wealth/awesome\"\u003e\u003cimg alt=\"Mentioned in Awesome Finary\" src=\"https://awesome.re/mentioned-badge-flat.svg\"\u003e\u003c/a\u003e\n\n  \u003csub\u003eConstruit avec ❤︎ par \u003ca href=\"https://github.com/sponsors/MadeInPierre\"\u003ePierre Laclau\u003c/a\u003e et \u003ca href=\"https://github.com/MadeInPierre/finalynx/graphs/contributors\"\u003econtributeurs\u003c/a\u003e. Logo généré par \u003ca href=\"https://midjourney.com\"\u003eMidjourney\u003c/a\u003e.\u003c/sub\u003e\n\n  \u003cbr\u003e\n\u003c/div\u003e\n\nFinalynx est votre \"assistant financier\", un outil en ligne de commande (et un tableau de bord web expérimental) pour organiser votre portefeuille d'investissements et obtenir des recommandations mensuelles automatisées basées sur vos objectifs de vie futurs.\nCet outil se synchronise avec votre compte Finary, un agrégateur de comptes d'investissement, pour afficher vos positions en temps réel.\n\nVous n'avez pas encore Finary ? Vous pouvez vous inscrire en utilisant mon [lien de parrainage](https://finary.com/referral/f8d349c922d1e1c8f0d2) 🌹 (ou via la page [par défaut](https://finary.com/signup)).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/MadeInPierre/finalynx/main/docs/_static/screenshot_demo_frameless.png\" width=\"600\" /\u003e\n\u003c/p\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\n  \u003cdiv align=\"center\"\u003e\n    \u003cstrong\u003e[Cliquer]\u003c/strong\u003e Captures d'écran supplémentaires 📸\n  \u003c/div\u003e\n\u003c/summary\u003e\n\n| Recommendations                                                                                                                    | Tableau de bord web                                                                                                          |\n| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| \u003cimg src=\"https://raw.githubusercontent.com/MadeInPierre/finalynx/main/docs/_static/screenshot_recommendations.png\" width=\"600\" /\u003e | \u003cimg src=\"https://raw.githubusercontent.com/MadeInPierre/finalynx/main/docs/_static/screenshot_dashboard.png\" width=\"600\" /\u003e |\n\nFinalynx comprend également un gestionnaire de budget quotidien pour classer vos dépenses et afficher des statistiques mensuelles et annuelles :\n\n\u003cimg src=\"https://raw.githubusercontent.com/MadeInPierre/finalynx/main/docs/_static/budget.png\"/\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/MadeInPierre/finalynx/main/docs/_static/budget_review.png\"/\u003e\n\nDes statistiques et des visualisations seront bientôt ajoutées !\n\n\u003c/details\u003e\n\n## ✨ Fonctionnalités\n\n1. **✅ Portefeuille:** Organisez vos actifs, fixez des objectifs et synchronisez avec votre compte Finary.\n2. **⏳ Tableau de bord web:** Générez des statistiques et graphiques pour comprendre chaque ligne ou dossier.\n3. **⏳ Assistant:** Obtenez des recommandations mensuelles sur vos investissements pour atteindre vos objectifs.\n4. **🔜 Simulateur:** Définissez vos objectifs et événements de vie, simulez l'avenir de votre portefeuille.\n5. **🙏 Extensions:** Faire fonctionner cet outil pour les situations d'autres personnes, contributions nécessaires 👀.\n\nVous pouvez consulter le [statut de développement actuel](https://github.com/users/MadeInPierre/projects/4). Les contributions sont les bienvenues !\n\n## 🚀 Installation\n\nSi vous n'avez pas l'intention de toucher au code, exécutez simplement (avec python \u003e=3.10 et pip installé) :\n\n```sh\npip install finalynx  # exécuter à nouveau avec --upgrade pour mettre à jour\n```\n\nEt c'est tout ! Maintenant, créez votre propre copie de l'exemple [`demo.py`](https://github.com/MadeInPierre/finalynx/blob/main/examples/demo.py) n'importe où et exécutez-le pour vous assurer que tout fonctionne. Vous pouvez maintenant le personnaliser pour vos propres besoins 🚀\n\n**Débutants:** Voici des [étapes détaillées](https://finalynx.readthedocs.io/en/latest/quickstart/installation.html#detailed-instructions) et une [vidéo](https://www.terminalizer.com/view/5fcce8cb5875). N'hésitez pas à [ouvrir une discussion](https://github.com/MadeInPierre/finalynx/discussions), avec plaisir pour aider !\n\n**Pro Tip 💡:** _Pourquoi pas créer un script pour lancer le projet dans un terminal à chaque démarrage ? Jolie vue_ 🤭\n\n## ⚙️ Utilisation et documentation\n\nL'objectif est de déclarer une arborescence de l'ensemble de votre portefeuille indépendamment de leurs enveloppes (e.g. PEA, AV, CTO, etc). Une fois que la stratégie de l'ensemble de votre portefeuille est définie dans Finalynx, trouvez la meilleure enveloppe pour chaque ligne et ajoutez-les à votre compte Finary (synchronisation manuelle ou automatique). Finalynx récupérera chaque ligne et affichera votre portefeuille complet avec les montants en temps réel.\n\nVoici le code minimal accepté :\n\n```python\nfrom finalynx import Portfolio, Assistant\nportfolio = Portfolio()     # \u003c- votre configuration personnalisée ici\nAssistant(portfolio).run()  # \u003c- voir les tutoriels pour plus d'options\n```\n\nVous pouvez maintenant remplir la classe `Portfolio` avec votre propre hiérarchie personnalisée en vous inspirant de l'exemple [`demo.py`](https://github.com/MadeInPierre/finalynx/blob/main/examples/demo.py) ou en lisant le guide [Getting Started](https://finalynx.readthedocs.io/en/latest/quickstart/getting_started.html) dans la documentation et les [Tutoriels](https://github.com/MadeInPierre/finalynx/tree/main/examples/tutorials) étape par étape. Pour plus de détails, consultez la [Référence API](https://finalynx.readthedocs.io/en/latest/apidocs/index.html) ou [posez une question](https://github.com/MadeInPierre/finalynx/discussions/new?category=q-a).\n\nUne fois que vous avez défini un arbre de portefeuille complet avec des objectifs raisonnables, vous pouvez afficher le montant que vous devez investir dans chaque ligne à l'aide de :\n\n```sh\npython your_config.py delta  # tapez --help pour d'autres options, comme le lancement d'un tableau de bord web !\n```\n\n## 👨‍💻 Feedback \u0026 Contributions\n\nCe projet en est encore à ses débuts. Malheureusement, je n'aurai pas le temps de faire fonctionner cet outil par défaut pour tout le monde, mais vous êtes les bienvenus d'étendre ce projet (ou [m'embaucher](https://github.com/sponsors/MadeInPierre/commissions) si vous ne pouvez pas le développer vous-même). Les pull requests, [issues](https://github.com/MadeInPierre/finalynx/issues/new) (🇬🇧 de préférence) et [discussions ouvertes](https://github.com/MadeInPierre/finalynx/discussions/new) (🇬🇧/🇫🇷) sont les bienvenues !\n\nSi vous souhaitez contribuer à ce projet, bienvenue à bord et merci de votre intérêt ! 🎉 Veuillez lire le [guide de contribution](https://github.com/MadeInPierre/finalynx/blob/main/CONTRIBUTING.md) pour configurer le projet sur votre machine et accepter les conventions communes. Le reste de la documentation est en anglais.\n\n## 📄 License\n\nCe projet est sous la [License GPLv3](https://github.com/MadeInPierre/finalynx/blob/main/LICENSE), ce qui signifie que tout le monde peut utiliser, partager, étendre et contribuer à ce projet tant que leurs changements sont intégrés à ce repo ou également publiés sous GPLv3. Contactez-moi pour toute demande de licence spécifique.\n\n## 💌 Donations\n\n[\u003cimg align=\"right\" src=\"https://raw.githubusercontent.com/MadeInPierre/finalynx/main/docs/_static/buymeacoffee.png\" width=\"161\" /\u003e](https://github.com/sponsors/MadeInPierre)\nCeci est un projet personnel sur lequel je m'amuse pendant mon temps libre. Si vous l'avez trouvé utile et souhaitez soutenir mon travail, vous pouvez [m'offrir un café](https://github.com/sponsors/MadeInPierre) ! Cela me donnerait la motivation nécessaire pour continuer à l'améliorer 😄 Merci !\n\nUn grand merci également à tous les contributeurs 🌹 n'oubliez pas d'aller les voir :\n\n\u003ca href=\"https://github.com/MadeInPierre/finalynx/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=MadeInPierre/finalynx\" /\u003e\n\u003c/a\u003e\n\n\u003c!-- ![Alt](https://repobeats.axiom.co/api/embed/44fc99b8a4a89962a0e1a7170f8d44cd3e9ea2e0.svg \"Repobeats analytics image\") --\u003e\n\n\u003c!-- Breaking: :boom:\n\nMinor: :sparkles::children_crossing::lipstick::iphone::egg::chart_with_upwards_trend:\n\nPatch: :ambulance::lock::bug::zap::goal_net::alien::wheelchair::speech_balloon::mag::apple::penguin::checkered_flag::robot::green_apple: --\u003e\n","funding_links":["https://github.com/sponsors/MadeInPierre","https://github.com/sponsors/MadeInPierre/commissions"],"categories":["Awesome Finary [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)","Python"],"sub_categories":["Community libraries \u0026 Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMadeInPierre%2Ffinalynx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMadeInPierre%2Ffinalynx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMadeInPierre%2Ffinalynx/lists"}