TradingAgents-CN est un frameowrk de trading financier s'appuyant sur des modèles de langage (LLM) multi-agents, spécifiquement conçu pour les marchés asiatiques. Ce guide technique détaille la procédure d'installation, de configuration et de lancement de l'environnement de développement.
Prérequis système
Avant d'initier le déploiement, assurez-vous que votre environnement de développement respecte les spécifications minimales suivantes :
- Runtime Python 3.8 ou version supérieure
- Client Git installé et configuré
- Connexion Internet stable pour le téléchargement des dépendances
- Mémoire RAM disponible : 2 Go minimum
Acquisition du code source
Extraire le dépôt officiel via Git en utilisant une variable d'environnement pour l'URL :
PROJECT_REPO="https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN"
git clone "$PROJECT_REPO"
cd TradingAgents-CN
Installation des dépendances
Le projet inclut des scripts d'automatisation pour configurer les environnements virtuels et installer les paquets requis. Exécutez la commande adaptée à votre système d'exploitation :
# Pour les systèmes Windows
powershell -ExecutionPolicy Bypass -File ./scripts/easy_install.ps1
# Pour les distributions Linux et macOS
chmod +x ./scripts/easy_install.sh
./scripts/easy_install.sh
Paramétrage initial
Une fois les dépendances résolues, exécutez le module CLI pour générer le fichier de configuration local et démarrer l'assistant interactif :
python -m cli.main
L'interface en ligne de commande vous demandera de définir les paramètres fondamentaux :
- Sélection de la bourse cible (Chine A, Hong Kong, ou États-Unis).
- Fourniture des clés API pour les fournisseurs de données de marché.
- Choix du profil d'agents d'analyse par défaut.
- Définition du répertoire local pour le stockage des données historiques.
Démarrage des services
L'application nécessite le lancement simultané du back end (moteur d'inférence) et de l'interface utilisateur frontend :
# Lancement du serveur principal en arrière-plan
python main.py &
# Démarrage du serveur de développement frontend
cd frontend
yarn dev
Interaction avec l'interface
Accédez à l'application via votre navigateur à l'adresse http://localhost:8080. Le tableau de bord principal permet de :
- Définir le ticker de l'actif et le marché financier associé.
- Ajuster la profondeur de l'analyse (du niveau 1 pour une analyse rapide au niveau 5 pour une évaluation exhaustive).
- Activer les agents spécifiques (analyse technique, sentiment des nouvelles, analyse fondamentale).
- Déclencher le processus de génération de signaux de trading.
Architecture multi-agents
Le système orchestre plusieurs entités autonomes qui collaborent pour fournir une analyse complète :
- Équipe de recherche : collecte et traite les données de marché sous plusieurs angles.
- Module de décision : synthétise les signaux divergents pour formuler une stratégie cohérente.
- Gestion des risques : calcule les ratios risque/rendement et propose des limites de position.
- Module d'exécution : traduit les décisions finales en ordres de marché structurés.
Analyse des rapports générés
Une fois le cycle de réflexion des agents terminé, le module de décision produit un rapport structuré dans l'onglet "Décision finale". Ce document contient :
- Les arguments détaillés des agents "haussiers" et "baissiers".
- La synthèse des débats inter-agents et la recommandation finale.
- Les métriques d'évaluation des risques et les suggestions d'allocation de capital.
Resssources de dépannage
En cas d'erreur lors de l'initialisation ou de l'exécution, consultez la documentation technique intégrée :
- Guide de démarrage rapide :
docs/QUICK_START.md - Résolution des problèmes courants :
docs/troubleshooting/ - Documentation des variables d'environnement :
config/README.md