1️⃣ Introduction

🎯 Qu’est-ce que l’Agent IA d’Auto-Optimisation ?

L’Agent IA est un composant intelligent de SkullTrading V3 qui analyse le marché et ajuste automatiquement les paramètres du bot.

• ✅ Analyse le marché en temps réel (168 heures de données)
• ✅ Détecte le régime de marché (tendance, volatilité, range…)
• ✅ Calcule les paramètres optimaux automatiquement
• ✅ Applique les modifications au fichier .env
• ✅ Peut tourner en continu (mode daemon)

⚡ Pourquoi utiliser l’Auto-Optimisation ?

2️⃣ Comment ça fonctionne

🔄 Cycle d’Optimisation

📊 Données Analysées

3️⃣ Les Régimes de Marché

L’IA détecte automatiquement 8 régimes de marché différents :

4️⃣ Installation et Configuration

📋 Prérequis

# Vérifier Python
python3 --version  # Doit être 3.10+

# Vérifier les dépendances
pip list | grep -E "numpy|pandas|requests|python-dotenv"

📦 Installation des dépendances

cd ~/skulltrading
source venv/bin/activate
pip install numpy pandas requests python-dotenv

⚙️ Configuration optionnelle (Claude API)

Pour activer l’analyse IA avancée avec Claude, ajoutez dans .env :

ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxxxxx

5️⃣ Utilisation en Ligne de Commande

🚀 Commande de base

cd ~/skulltrading
source venv/bin/activate
python agents/ai_optimizer.py

📋 Options disponibles

💡 Exemple de sortie

============================================================
💀 SKULLTRADING V3 - OPTIMISATION IA
============================================================

📊 ANALYSE DU MARCHÉ
----------------------------------------
  Régime:      weak_uptrend
  Tendance:    +0.45%
  Volatilité:  2.34%
  RSI:         58.2
  Volume:      1.15x
  Confiance:   72%

🎯 PARAMÈTRES OPTIMISÉS
----------------------------------------
  📈 Tendance haussière modérée - Configuration équilibrée

  Consensus:
    Score BUY:     50%
    Score SELL:    50%
    Agents min:    2

  Risque:
    Stop-Loss:     1.50%
    Take-Profit:   4.50%
    Ratio R/R:     1:3
    Trailing:      Oui

  Timing:
    Cycle:         60s
    Timeframe:     15m
    Max trades/j:  10

  Win Rate attendu: ~45%
============================================================

6️⃣ Mode Daemon (Automatique)

🔄 Démarrer le daemon

# Optimisation toutes les 4 heures (défaut)
python agents/ai_optimizer.py --daemon

# Optimisation toutes les heures
python agents/ai_optimizer.py --daemon --interval 1

# Optimisation toutes les 30 minutes
python agents/ai_optimizer.py --daemon --interval 0.5

📺 Utiliser avec Screen

# Créer une session Screen
screen -S ai_optimizer

# Lancer le daemon
cd ~/skulltrading
source venv/bin/activate
python agents/ai_optimizer.py --daemon --interval 1

# Détacher : Ctrl+A puis D

📋 Commandes Screen

7️⃣ Service Systemd

🔧 Créer le service

sudo nano /etc/systemd/system/skulltrading-ai.service

Contenu :

[Unit]
Description=SkullTrading AI Optimizer
After=network.target

[Service]
Type=simple
User=skulltrading
WorkingDirectory=/home/skulltrading/skulltrading
ExecStart=/home/skulltrading/skulltrading/venv/bin/python agents/ai_optimizer.py --daemon --interval 1
Restart=always
RestartSec=60

[Install]
WantedBy=multi-user.target

⚙️ Commandes de gestion

🔄 Modifier l’intervalle

# Éditer le service
sudo nano /etc/systemd/system/skulltrading-ai.service

# Changer --interval N (N = heures)

# Recharger et redémarrer
sudo systemctl daemon-reload
sudo systemctl restart skulltrading-ai

8️⃣ Paramètres Optimisés par Régime

📈 STRONG_UPTREND (Forte hausse)

⚠️ HIGH_VOLATILITY (Haute volatilité)

😴 LOW_VOLATILITY (Basse volatilité)

9️⃣ Analyse IA Avancée (Claude)

🤖 Qu’est-ce que c’est ?

Si vous avez une clé API Anthropic, l’agent peut demander une analyse complémentaire à Claude pour des insights supplémentaires.

⚙️ Configuration

Ajoutez dans votre fichier .env :

ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxxxxx

📊 Exemple de sortie

🤖 ANALYSE IA
----------------------------------------
  Le marché montre une tendance haussière modérée avec une volatilité 
  maîtrisée. Le RSI à 58 suggère une marge de progression. Je recommande 
  de maintenir les positions avec un trailing stop pour sécuriser les gains.

🔟 Toutes les Commandes

📋 Commandes Agent IA

📋 Commandes Service Systemd

1️⃣1️⃣ Dépannage

cd ~/skulltrading
source venv/bin/activate
pip install numpy pandas requests python-dotenv

curl -s "https://api.binance.com/api/v3/ping"
# Doit retourner : {}

sudo systemctl restart skulltrading

1️⃣2️⃣ Bonnes Pratiques

✅ Recommandations

• Commencez par --dry-run : Vérifiez toujours les suggestions avant d’appliquer
• Intervalle recommandé : 1 heure est un bon compromis
• Surveillez les logs : journalctl -u skulltrading-ai -f
• Redémarrez le bot après optimisation

⚠️ Avertissements

• ❌ Ne modifiez pas manuellement le .env pendant que le daemon tourne
• ❌ N’utilisez pas d’intervalle trop court (< 30 min)
• ❌ Ne lancez pas plusieurs instances de l’agent en même temps