Mode d’emploi interface avec IA

💀 SkullTrading V3 – Mode d’Emploi Interface de Configuration
💀

SkullTrading V3

Mode d’Emploi – Interface de Configuration

Version 3.0 | 29 Novembre 2025 | Pour HB9HPG

1️⃣ Introduction

🎯 Qu’est-ce que le Dashboard de Configuration ?

Le Dashboard de Configuration est une interface web graphique (GUI) qui vous permet de :

  • ✅ Modifier tous les paramètres du bot visuellement
  • ✅ Voir le prix du Bitcoin en temps réel
  • ✅ Utiliser l’IA pour optimiser automatiquement les paramètres
  • ✅ Appliquer des profils de configuration prédéfinis
  • ✅ Configurer les API Binance et Telegram
  • ✅ Sauvegarder directement dans le fichier .env

⚡ Pourquoi utiliser l’interface graphique ?

┌─────────────────────────────────────────────────────────────────┐ │ │ │ AVANT (modification manuelle) APRÈS (avec Dashboard) │ │ ───────────────────────────── ────────────────────── │ │ │ │ 1. Connexion SSH 1. Ouvrir navigateur │ │ 2. nano ~/.env 2. Modifier les sliders │ │ 3. Chercher le paramètre 3. Cliquer « Sauvegarder » │ │ 4. Modifier la valeur 4. C’est fait ! │ │ 5. Sauvegarder │ │ 6. Redémarrer le bot │ │ │ │ ⏱️ ~5 minutes ⏱️ ~30 secondes │ │ │ └─────────────────────────────────────────────────────────────────┘

🎨 Design de l’interface

L’interface utilise un thème Grafana professionnel :

  • Fond sombre : Repose les yeux, idéal pour le monitoring
  • 🔵 Bleu Actions principales
  • 🟢 Vert Succès, valeurs positives
  • 🟠 Orange Avertissements
  • 🔴 Rouge Erreurs, valeurs négatives

2️⃣ Installation et Démarrage

📋 Prérequis

  • ✅ SkullTrading V3 installé sur votre VPS
  • ✅ Python 3.10+ avec l’environnement virtuel activé
  • ✅ Streamlit installé

📦 Installation des dépendances

# Se connecter au VPS
ssh utilisateur@IP_DU_VPS

# Aller dans le dossier SkullTrading
cd ~/skulltrading

# Activer l'environnement virtuel
source venv/bin/activate

# Installer Streamlit et les dépendances
pip install streamlit pandas numpy python-dotenv requests

🚀 Démarrage rapide

# 1. Aller dans le dossier
cd ~/skulltrading

# 2. Activer l'environnement virtuel
source venv/bin/activate

# 3. Lancer le dashboard
streamlit run web/config_gui_grafana.py --server.port 8501 --server.address 0.0.0.0

🌐 Accéder à l’interface

Ouvrez votre navigateur web et allez à :

http://IP_DE_VOTRE_VPS:8501

Exemple : http://83.228.212.170:8501

⚠️ Si le port est bloqué
# Ouvrir le port 8501 dans le firewall
sudo ufw allow 8501/tcp
sudo ufw reload

3️⃣ Garder le Dashboard Actif (Screen)

❓ Le problème

Quand vous fermez votre connexion SSH, tous les programmes lancés dans ce terminal s’arrêtent, y compris le dashboard.

✅ La solution : Screen

Screen est un outil qui permet de créer des « sessions » qui continuent de tourner même après déconnexion.

┌─────────────────────────────────────────────────────────────────┐ │ │ │ SANS Screen : │ │ ───────────── │ │ Vous ──► SSH ──► Terminal ──► Streamlit │ │ │ │ │ Fermer SSH = Tout s’arrête ❌ │ │ │ │ AVEC Screen : │ │ ───────────── │ │ Vous ──► SSH ──► Screen ──► Streamlit │ │ │ │ │ Fermer SSH = Screen continue ✅ │ │ │ └─────────────────────────────────────────────────────────────────┘

📦 Installation de Screen

sudo apt install screen -y

📝 Utilisation étape par étape

  1. Créer une nouvelle session
    screen -S dashboard

    Cela crée une session nommée « dashboard » et vous y connecte.

  2. Lancer le dashboard
    cd ~/skulltrading
    source venv/bin/activate
    streamlit run web/config_gui_grafana.py --server.port 8501 --server.address 0.0.0.0
  3. Détacher la session

    Appuyez sur ces touches dans l’ordre :

    Ctrl + A puis D

    Vous verrez : [detached from 12345.dashboard]

  4. Fermer SSH

    Vous pouvez maintenant fermer votre connexion SSH. Le dashboard reste actif.

📋 Commandes Screen essentielles

Action Commande Description
Créer une session screen -S nom Crée et entre dans une session
Détacher Ctrl+A puis D Sort sans arrêter le programme
Lister les sessions screen -ls Voir toutes les sessions actives
Revenir à une session screen -r nom Reprendre une session
Tuer une session screen -X -S nom quit Arrête complètement la session

4️⃣ Présentation de l’Interface

🖥️ Vue d’ensemble

┌─────────────────────────────────────────────────────────────────────────────┐ │ │ │ ┌──────────┐ ┌─────────────────────────────────────────────────────────┐ │ │ │ │ │ ZONE PRINCIPALE │ │ │ │ SIDEBAR │ │ │ │ │ │ │ │ ┌─────────────────────────────────────────────────┐ │ │ │ │ • BTC │ │ │ MÉTRIQUES (Prix, SL, TP, etc.) │ │ │ │ │ Prix │ │ └─────────────────────────────────────────────────┘ │ │ │ │ │ │ │ │ │ │ • Mode │ │ ┌─────┬─────────┬─────────┬────────────────────┐ │ │ │ │ • Paire │ │ │ ⚙️ │ 🤖 │ 📊 │ 🔐 │ │ │ │ │ • Cycle │ │ │Param│ Auto-IA │ Profils │ API & Notif │ │ │ │ │ │ │ └─────┴─────────┴─────────┴────────────────────┘ │ │ │ │ • R/R │ │ │ │ │ │ │ │ CONTENU DE L’ONGLET │ │ │ │ • Actions│ │ │ │ │ └──────────┘ └─────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────────┘

📊 La Sidebar (barre latérale)

Élément Description
💀 SkullTrading V3 Titre de l’application
BTC/USDT Prix actuel + variation 24h
Mode 🟢 DEMO ou 🔴 PROD
Paire BTCUSDT
Cycle Intervalle en secondes
Ratio R/R Ratio Risk/Reward actuel

🗂️ Les 4 onglets

Onglet Icône Fonction
Paramètres ⚙️ Modifier manuellement tous les paramètres
Auto-Optimisation IA 🤖 Laisser l’IA analyser et optimiser
Profils 📊 Appliquer des configurations prédéfinies
API & Notifications 🔐 Configurer Binance et Telegram

5️⃣ Onglet Paramètres

🎯 Section Consensus

Score minimum ACHAT (30% – 80%)

C’est le score de confiance minimum pour déclencher un achat.

Valeur Signification Trades/semaine
30% Très agressif ~50+
40% Agressif ~30
50% Modéré (recommandé) ~15
60% Conservateur ~8
70% Très conservateur ~3

Agents minimum d’accord (1 – 5)

Valeur Signification
1 Un seul agent suffit (très risqué)
2 2 agents minimum (recommandé)
3 3 agents minimum (conservateur)

🛡️ Section Gestion des Risques

Stop-Loss et Take-Profit

┌─────────────────────────────────────────────────────────────────┐ │ │ │ Prix d’achat : 95,000 USDT │ │ │ │ Stop-Loss 1.0% → 94,050 USDT (perte max : 950 USDT) │ │ Stop-Loss 1.5% → 93,575 USDT (perte max : 1,425 USDT) │ │ Stop-Loss 2.0% → 93,100 USDT (perte max : 1,900 USDT) │ │ │ │ Take-Profit 3.0% → 97,850 USDT (gain : 2,850 USDT) │ │ Take-Profit 4.5% → 99,275 USDT (gain : 4,275 USDT) │ │ Take-Profit 6.0% → 100,700 USDT (gain : 5,700 USDT) │ │ │ └─────────────────────────────────────────────────────────────────┘

🔄 Trailing Stop

Le Trailing Stop suit le prix à la hausse et protège les gains.

┌─────────────────────────────────────────────────────────────────┐ │ │ │ Sans Trailing Stop : │ │ Achat à 95,000 → SL fixe à 93,575 (1.5%) │ │ Prix monte à 100,000 → SL toujours à 93,575 │ │ Prix redescend → Vous perdez tous les gains ! ❌ │ │ │ │ Avec Trailing Stop (1%) : │ │ Achat à 95,000 → SL à 93,575 │ │ Prix monte à 100,000 → SL monte à 99,000 │ │ Prix redescend → Vente à ~99,000 = Gain protégé ! ✅ │ │ │ └─────────────────────────────────────────────────────────────────┘

📊 Résumé et Ratios

Ratio R/R = Take-Profit ÷ Stop-Loss

Win Rate minimum = Pour être rentable avec un ratio 1:3, il faut gagner au moins 25% des trades.

⚠️ Important

Après avoir sauvegardé, redémarrez le bot :

sudo systemctl restart skulltrading

6️⃣ Auto-Optimisation IA

🧠 Comment ça fonctionne ?

L’IA analyse automatiquement le marché et suggère des paramètres optimaux.

📊 Données analysées
  • 168 heures de données (7 jours)
  • Volatilité du marché
  • Direction et force de la tendance
  • RSI (Relative Strength Index)
  • Volume relatif

📈 Les régimes de marché

Régime Emoji Description Stratégie
UPTREND 📈 Tendance haussière Suivre la tendance, trailing stop
DOWNTREND 📉 Tendance baissière Prudence, moins de trades
RANGING ↔️ Marché latéral Capturer les oscillations
HIGH_VOLATILITY ⚠️ Haute volatilité Très prudent, stops larges
LOW_VOLATILITY 😴 Basse volatilité Scalping, stops serrés

🔍 Comment utiliser

  1. Cliquer sur « ANALYSER LE MARCHÉ ET OPTIMISER »
  2. Voir les résultats : Régime détecté, volatilité, tendance, RSI
  3. Voir les paramètres suggérés
  4. Cliquer sur « APPLIQUER CES PARAMÈTRES » (optionnel)

7️⃣ Onglet Profils

Un profil est une configuration prédéfinie adaptée à un style de trading.

🛡️ Profil PRUDENT

Pour les débutants, capital limité, aversion au risque

Score min
60%
SL / TP
1% / 3%
Trades/jour
5

⚖️ Profil MODÉRÉ Recommandé

Bon équilibre risque/récompense pour la plupart des utilisateurs

Score min
50%
SL / TP
1.5% / 4.5%
Trades/jour
10

🚀 Profil AGRESSIF

Pour traders expérimentés avec tolérance au risque élevée

Score min
40%
SL / TP
2% / 6%
Trades/jour
20

🎯 Profil SCALPING

Trading très court terme, beaucoup de petits trades

Score min
45%
SL / TP
0.5% / 1.5%
Trades/jour
30

8️⃣ API & Notifications

🔑 Configuration Binance

Mode URL Argent Recommandation
🟢 DEMO demo.binance.com Fictif Pour tester
🔴 PROD binance.com Réel Après tests concluants

📱 Configuration Telegram

  1. Créer un bot : Chercher @BotFather sur Telegram, envoyer /newbot
  2. Obtenir le Chat ID : Chercher @userinfobot, envoyer /start
  3. Configurer dans le dashboard : Cocher « Activer Telegram », coller le Token et Chat ID
  4. Tester : Cliquer sur le bouton « 🔔 Tester »

9️⃣ Agent IA en Ligne de Commande

En plus du dashboard, vous pouvez utiliser l’agent IA directement en ligne de commande.

📋 Options disponibles

Option Description Exemple
--once Exécute une seule fois python agents/ai_optimizer.py --once
--dry-run Voir sans appliquer python agents/ai_optimizer.py --dry-run
--daemon Mode automatique continu python agents/ai_optimizer.py --daemon
--interval N Intervalle en heures --daemon --interval 4

💡 Exemples

# Voir les suggestions sans appliquer
python agents/ai_optimizer.py --dry-run

# Appliquer les optimisations
python agents/ai_optimizer.py

# Mode daemon (optimise toutes les 4 heures)
python agents/ai_optimizer.py --daemon --interval 4

🔟 Toutes les Commandes

🖥️ Dashboard

Lancer le dashboard
streamlit run web/config_gui_grafana.py --server.port 8501 --server.address 0.0.0.0
Arrêter le dashboard
pkill -f streamlit

📺 Screen

Créer une session
screen -S dashboard
Détacher
Ctrl+A puis D
Lister les sessions
screen -ls
Revenir à une session
screen -r dashboard

🤖 Bot SkullTrading

Démarrer
sudo systemctl start skulltrading
Arrêter
sudo systemctl stop skulltrading
Redémarrer
sudo systemctl restart skulltrading
Voir les logs
journalctl -u skulltrading -f

🔥 Firewall

Voir le statut
sudo ufw status
Ouvrir un port
sudo ufw allow 8501/tcp

1️⃣1️⃣ Dépannage

❌ « Port 8501 is already in use »
# Tuer le processus qui utilise le port
pkill -f streamlit
# ou
fuser -k 8501/tcp

# Relancer
streamlit run web/config_gui_grafana.py --server.port 8501 --server.address 0.0.0.0
⚠️ Impossible d’accéder à l’interface

Vérifications :

# Le dashboard tourne-t-il ?
ps aux | grep streamlit

# Le port est-il ouvert ?
sudo ufw status | grep 8501

# Le port écoute-t-il ?
ss -tlnp | grep 8501
ℹ️ Les modifications ne s’appliquent pas

Après avoir sauvegardé, il faut redémarrer le bot :

sudo systemctl restart skulltrading

1️⃣2️⃣ Bonnes Pratiques

🔄 Workflow recommandé

  1. Analyser le marché avec l’IA → Onglet « Auto-Optimisation IA »
  2. Vérifier les paramètres suggérés → Sont-ils cohérents ?
  3. Ajuster manuellement si nécessaire → Onglet « Paramètres »
  4. Sauvegarder → Bouton « Sauvegarder Configuration »
  5. Redémarrer le botsudo systemctl restart skulltrading
  6. Surveiller les résultats → Logs, Telegram, Binance

📅 Fréquence d’optimisation

Situation Fréquence recommandée
Marché stable 1 fois par semaine
Marché volatil 1 fois par jour
Événement majeur Immédiatement
Mode daemon Toutes les 4-6 heures

🔒 Sécurité

  • ⚠️ Ne partagez jamais vos clés API
  • ⚠️ Utilisez le mode DEMO pour tester
  • ⚠️ Ne laissez pas le port 8501 ouvert si non utilisé

📋 AIDE-MÉMOIRE RAPIDE

🚀 LANCER LE DASHBOARD :
   screen -S dashboard
   cd ~/skulltrading && source venv/bin/activate
   streamlit run web/config_gui_grafana.py --server.port 8501 --server.address 0.0.0.0
   Ctrl+A, D (pour détacher)

🌐 ACCÉDER :
   http://IP_DU_VPS:8501

🔄 APRÈS MODIFICATION :
   sudo systemctl restart skulltrading

📋 SESSIONS SCREEN :
   screen -ls          (lister)
   screen -r dashboard (revenir)
   Ctrl+A, D           (détacher)

🤖 OPTIMISATION IA CLI :
   python agents/ai_optimizer.py --dry-run
   python agents/ai_optimizer.py --daemon --interval 4