Skip to content

Latest commit

 

History

History
126 lines (82 loc) · 9.52 KB

README.fr.md

File metadata and controls

126 lines (82 loc) · 9.52 KB


Finalynx Assistant

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

Outil de ligne de commande minimaliste pour vous aider à gérer vos investissements

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

Construit avec ❤︎ par Pierre Laclau et contributeurs. Logo généré par Midjourney.


Finalynx 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. Cet outil se synchronise avec votre compte Finary, un agrégateur de comptes d'investissement, pour afficher vos positions en temps réel.

Vous n'avez pas encore Finary ? Vous pouvez vous inscrire en utilisant mon lien de parrainage 🌹 (ou via la page par défaut).

[Cliquer] Captures d'écran supplémentaires 📸
Recommendations Tableau de bord web

Finalynx comprend également un gestionnaire de budget quotidien pour classer vos dépenses et afficher des statistiques mensuelles et annuelles :

Des statistiques et des visualisations seront bientôt ajoutées !

✨ Fonctionnalités

  1. ✅ Portefeuille: Organisez vos actifs, fixez des objectifs et synchronisez avec votre compte Finary.
  2. ⏳ Tableau de bord web: Générez des statistiques et graphiques pour comprendre chaque ligne ou dossier.
  3. ⏳ Assistant: Obtenez des recommandations mensuelles sur vos investissements pour atteindre vos objectifs.
  4. 🔜 Simulateur: Définissez vos objectifs et événements de vie, simulez l'avenir de votre portefeuille.
  5. 🙏 Extensions: Faire fonctionner cet outil pour les situations d'autres personnes, contributions nécessaires 👀.

Vous pouvez consulter le statut de développement actuel. Les contributions sont les bienvenues !

🚀 Installation

Si vous n'avez pas l'intention de toucher au code, exécutez simplement (avec python >=3.10 et pip installé) :

pip install finalynx  # exécuter à nouveau avec --upgrade pour mettre à jour

Et c'est tout ! Maintenant, créez votre propre copie de l'exemple demo.py n'importe où et exécutez-le pour vous assurer que tout fonctionne. Vous pouvez maintenant le personnaliser pour vos propres besoins 🚀

Débutants: Voici des étapes détaillées et une vidéo. N'hésitez pas à ouvrir une discussion, avec plaisir pour aider !

Pro Tip 💡: Pourquoi pas créer un script pour lancer le projet dans un terminal à chaque démarrage ? Jolie vue 🤭

⚙️ Utilisation et documentation

L'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.

Voici le code minimal accepté :

from finalynx import Portfolio, Assistant
portfolio = Portfolio()     # <- votre configuration personnalisée ici
Assistant(portfolio).run()  # <- voir les tutoriels pour plus d'options

Vous pouvez maintenant remplir la classe Portfolio avec votre propre hiérarchie personnalisée en vous inspirant de l'exemple demo.py ou en lisant le guide Getting Started dans la documentation et les Tutoriels étape par étape. Pour plus de détails, consultez la Référence API ou posez une question.

Une 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 :

python your_config.py delta  # tapez --help pour d'autres options, comme le lancement d'un tableau de bord web !

👨‍💻 Feedback & Contributions

Ce 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 si vous ne pouvez pas le développer vous-même). Les pull requests, issues (🇬🇧 de préférence) et discussions ouvertes (🇬🇧/🇫🇷) sont les bienvenues !

Si vous souhaitez contribuer à ce projet, bienvenue à bord et merci de votre intérêt ! 🎉 Veuillez lire le guide de contribution pour configurer le projet sur votre machine et accepter les conventions communes. Le reste de la documentation est en anglais.

📄 License

Ce projet est sous la License GPLv3, 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.

💌 Donations

Ceci 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é ! Cela me donnerait la motivation nécessaire pour continuer à l'améliorer 😄 Merci !

Un grand merci également à tous les contributeurs 🌹 n'oubliez pas d'aller les voir :