SkullTrading V3
Mode d’Emploi – Interface de Configuration
Version 3.0 | 29 Novembre 2025 | Pour HB9HPG
📋 Table des Matières
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 ?
🎨 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
# 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.
📦 Installation de Screen
sudo apt install screen -y
📝 Utilisation étape par étape
-
Créer une nouvelle session
screen -S dashboardCela crée une session nommée « dashboard » et vous y connecte.
-
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 -
Détacher la session
Appuyez sur ces touches dans l’ordre :
Ctrl + A puis D
Vous verrez :
[detached from 12345.dashboard] -
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
📊 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
🔄 Trailing Stop
Le Trailing Stop suit le prix à la hausse et protège les gains.
📊 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.
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.
- 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
- Cliquer sur « ANALYSER LE MARCHÉ ET OPTIMISER »
- Voir les résultats : Régime détecté, volatilité, tendance, RSI
- Voir les paramètres suggérés
- 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
⚖️ Profil MODÉRÉ Recommandé
Bon équilibre risque/récompense pour la plupart des utilisateurs
🚀 Profil AGRESSIF
Pour traders expérimentés avec tolérance au risque élevée
🎯 Profil SCALPING
Trading très court terme, beaucoup de petits trades
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
- Créer un bot : Chercher @BotFather sur Telegram, envoyer /newbot
- Obtenir le Chat ID : Chercher @userinfobot, envoyer /start
- Configurer dans le dashboard : Cocher « Activer Telegram », coller le Token et Chat ID
- 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
streamlit run web/config_gui_grafana.py --server.port 8501 --server.address 0.0.0.0
pkill -f streamlit
📺 Screen
screen -S dashboard
Ctrl+A puis D
screen -ls
screen -r dashboard
🤖 Bot SkullTrading
sudo systemctl start skulltrading
sudo systemctl stop skulltrading
sudo systemctl restart skulltrading
journalctl -u skulltrading -f
🔥 Firewall
sudo ufw status
sudo ufw allow 8501/tcp
1️⃣1️⃣ Dépannage
# 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
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
Après avoir sauvegardé, il faut redémarrer le bot :
sudo systemctl restart skulltrading
1️⃣2️⃣ Bonnes Pratiques
🔄 Workflow recommandé
- Analyser le marché avec l’IA → Onglet « Auto-Optimisation IA »
- Vérifier les paramètres suggérés → Sont-ils cohérents ?
- Ajuster manuellement si nécessaire → Onglet « Paramètres »
- Sauvegarder → Bouton « Sauvegarder Configuration »
- Redémarrer le bot →
sudo systemctl restart skulltrading - 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
