/ work / alphapilot
AlphaPilot — Plateforme autonome de trading
18 agents IA + Risk Engine déterministe — validation paper avant capital réel
→ Impact métier : Architecture séparation agents / risk engine — kill switch dur · validation paper avant capital réel.
- Client
- Projet personnel — en développement
- Rôle
- Architecte & lead engineer
- Période
- 2025 → aujourd'hui
- Statut
- paper-trading
- v1.5.0 shipped
- 608 tests
- 95 % coverage
- ✓ kill switch
Contexte
AlphaPilot est une plateforme autonome de trading : une architecture multi-agents qui reproduit la structure d’une salle de marché — analystes, gestion du risque, exécution, supervision — mais pilotée par des LLM et des règles déterministes plutôt que par des humains.
La V1 opère en paper-trading (ordres simulés, aucun capital réel). L’objet du projet n’est pas de promettre des rendements : c’est de prouver qu’un système agentic peut décider et exécuter sous contrainte de risque stricte, de façon auditable et reproductible.
Défi technique
Les systèmes agentic sont probabilistes ; une salle de marché ne peut pas l’être sur la partie risque. Le défi central : laisser les agents raisonner librement, tout en rendant l’exécution et les garde-fous 100 % déterministes et testables.
- Empêcher un agent « halluciné » de placer un ordre hors limites.
- Garantir un arrêt d’urgence instantané qui prime sur toute décision.
- Rendre chaque décision traçable — quel agent, quel signal, quelle contrainte.
Solution
Séparation nette entre la couche de raisonnement (agents LLM, non déterministe) et la couche d’exécution + risque (code déterministe, entièrement testé). Aucun ordre ne franchit le Risk Engine sans validation.
Market data ─▶ Analyst agents (LangGraph) ─▶ signals
│
┌──────────────────────▼──────────────────────┐
│ RISK ENGINE (déterministe, 95 % coverage) │
│ limites · exposition · drawdown · veto │
└──────────────────────┬──────────────────────┘
│ (approved only)
KILL SWITCH ◀──────────────┤
▼
Execution + audit log
- 18 agents spécialisés orchestrés en graphe (LangGraph), état partagé.
- Risk Engine déterministe : limites d’exposition, drawdown, position sizing — du code pur, couvert à 95 %, qui peut opposer un veto à n’importe quel agent.
- Kill Switch prioritaire : coupe toute exécution en un appel, indépendamment de l’état des agents.
- 608 tests unitaires + intégration sur la logique de risque et d’exécution.
- Contrat broker unifié : port
BrokerAdapter+ hookon_fill+ historique.fills.AlpacaPaperBrokeren sandbox ; fallbackPaperBrokeroffline pour les tests et la démo CLI.
Résultat
- v1.5.0 livrée — pipeline complet data → décision → exécution paper → audit.
- 608 tests, 95 % de couverture sur les chemins critiques.
- Kill switch et Risk Engine vérifiés : aucun ordre ne contourne les limites.
- Dashboard Next.js pour observer décisions et P&L simulé en temps réel.
Learnings & trade-offs
- La frontière déterministe est le produit. La valeur n’est pas dans les agents « intelligents » mais dans la barrière testée qui les contient.
- Paper-trading d’abord, assumé : pas de backtest gonflé présenté comme du réel.
- Roadmap V2→V4 : Redis + LLM agents, agents éphémères + auto-amélioration, Fund Mode avec capital réel après revue.
Limites — dit publiquement
- · Paper-trading uniquement — aucun capital réel engagé en V1.
- · Broker Alpaca en sandbox ; le contrat broker unifié est câblé mais la revue capital-réel arrive en V4.
- · Pas d'attribution de performance par stratégie encore — V2.