Guide Utilisateur Complet de Comfy CLI
Comfy CLI est l’outil officiel en ligne de commande fourni par ComfyUI. Il simplifie non seulement le processus d’installation de ComfyUI, mais offre également de puissantes capacités de gestion. Ce guide couvrira de manière complète toutes les fonctionnalités de Comfy CLI.
Commandes de Base
Installation et Configuration
# Installer comfy-cli
pip install comfy-cli
# Activer l'auto-complétion en ligne de commande
comfy --install-completion
# Installer ComfyUI
comfy install
# Lancer ComfyUI
comfy launch
Gestion des Espaces de Travail
comfy-cli prend en charge la gestion de plusieurs espaces de travail ComfyUI, vous permettant de maintenir différents environnements ComfyUI simultanément :
Opérations de Base des Espaces de Travail
# Vérifier le chemin de l'espace de travail actuel
comfy which
# Définir l'espace de travail par défaut
comfy set-default /chemin/vers/votre/espace-de-travail
# Définir l'espace de travail par défaut avec paramètres de lancement
comfy set-default /chemin/vers/votre/espace-de-travail --launch-extras="--listen 0.0.0.0 --port 8080"
Exécuter des Commandes dans Différents Espaces de Travail
1. Spécifier l’espace de travail :
# Lancer ComfyUI dans un espace de travail spécifique
comfy --workspace=/chemin/vers/espace-de-travail launch
# Installer des nœuds dans un espace de travail spécifique
comfy --workspace=/chemin/vers/espace-de-travail node install ComfyUI-Impact-Pack
2. Utiliser l’espace de travail récent :
# Lancer le ComfyUI le plus récemment utilisé
comfy --recent launch
# Mettre à jour les nœuds dans l'espace de travail récent
comfy --recent node update all
3. Opérer dans le répertoire actuel :
# Installer des nœuds dans le ComfyUI du répertoire actuel
comfy --here node install ComfyUI-Impact-Pack
# Lancer ComfyUI dans le répertoire actuel
comfy --here launch
# Vérifier si le répertoire actuel a ComfyUI
comfy --here which
Restrictions des Options d’Espaces de Travail
Note Importante : Les options
--workspace
,--recent
et--here
ne peuvent pas être utilisées simultanément.
Règles de Priorité des Espaces de Travail
Lorsque vous ne spécifiez pas explicitement un espace de travail, comfy-cli sélectionnera automatiquement selon la priorité suivante :
- Chemin ComfyUI par défaut spécifié via
comfy set-default <path>
- ComfyUI exécuté ou installé le plus récemment
- ComfyUI dans le répertoire actuel
Exemples d’Usage Pratique
Scénario 1 : Créer des Environnements Indépendants pour Différents Projets
# Créer un espace de travail pour le Projet A
comfy --workspace=~/projets/projetA install
# Créer un espace de travail pour le Projet B
comfy --workspace=~/projets/projetB install
# Installer des nœuds spécifiques dans le Projet A
comfy --workspace=~/projets/projetA node install ComfyUI-AnimateDiff-Evolved
# Installer différents nœuds dans le Projet B
comfy --workspace=~/projets/projetB node install ComfyUI-Impact-Pack
Scénario 2 : Changement Rapide d’Environnements
# Définir l'espace de travail fréquemment utilisé comme défaut
comfy set-default ~/projets/espace-de-travail-principal
# Travailler temporairement dans un autre espace de travail
comfy --workspace=~/projets/espace-de-travail-test launch
# Retourner à l'espace de travail par défaut
comfy launch
Options de Lancement
ComfyUI fournit de riches options de lancement pour répondre à différents besoins :
Lancement de Base
# Lancement par défaut
comfy launch
# Exécuter en arrière-plan
comfy launch --background
# Arrêter l'instance en arrière-plan
comfy stop
Configuration Réseau
# Spécifier l'adresse d'écoute et le port
comfy launch -- --listen 0.0.0.0 --port 8080
# Permettre l'accès externe
comfy launch -- --listen 0.0.0.0
Optimisation des Performances
# Utiliser le mode CPU
comfy launch -- --cpu
# Mode VRAM faible
comfy launch -- --lowvram
# Mode VRAM ultra-faible
comfy launch -- --novram
# Activer le déchargement de modèle vers CPU
comfy launch -- --cpu-vae
Gestion des Nœuds Personnalisés
Visualisation des Informations des Nœuds
# Afficher toutes les informations des nœuds disponibles
comfy node show all
# Affichage simple des nœuds installés
comfy node simple-show installed
# Afficher les nœuds activés
comfy node show enabled
# Afficher les nœuds non installés
comfy node show not-installed
# Afficher les nœuds désactivés
comfy node show disabled
# Afficher les nœuds du canal spécifique
comfy node show all --channel recent
Installation et Mises à Jour des Nœuds
# Installer des nœuds personnalisés
comfy node install ComfyUI-Impact-Pack
# Mettre à jour tous les nœuds
comfy node update all
# Mettre à jour un nœud spécifique
comfy node update ComfyUI-Impact-Pack
Gestion des Instantanés de Nœuds
La fonctionnalité d’instantané vous aide à sauvegarder et restaurer les états de configuration des nœuds :
# Sauvegarder un instantané de nœuds
comfy node save-snapshot
# Voir la liste des instantanés
comfy node show snapshot-list
# Restaurer un instantané de nœuds
comfy node restore-snapshot <nom_instantané>
Gestion des Dépendances
# Installer les dépendances depuis un fichier de workflow
comfy node install-deps --workflow=workflow.json
# Installer les dépendances depuis un fichier PNG de workflow
comfy node install-deps --workflow=workflow.png
# Installer depuis un fichier JSON de dépendances
comfy node install-deps --deps=dependencies.json
# Générer un fichier de dépendances de workflow
comfy node deps-in-workflow --workflow=workflow.json --output=deps.json
Dépannage des Nœuds (Bisect)
Lorsque vous rencontrez des conflits ou des problèmes de nœuds, utilisez la fonctionnalité bisect pour identifier rapidement les nœuds problématiques :
# Commencer une session de dépannage
comfy node bisect start
# Marquer l'état actuel comme bon
comfy node bisect good
# Marquer l'état actuel comme problématique
comfy node bisect bad
# Réinitialiser la session de dépannage
comfy node bisect reset
Gestion des Modèles
Téléchargements de Modèles
# Télécharger des modèles depuis une URL (prend en charge CivitAI, Hugging Face, etc.)
comfy model download --url https://huggingface.co/model/url
# Télécharger vers un chemin relatif spécifique
comfy model download --url https://civitai.com/api/download/models/123456 --relative-path models/checkpoints
# Définir le Token API CivitAI (pour télécharger des modèles nécessitant une connexion)
comfy model download --url https://civitai.com/api/download/models/123456 --set-civitai-api-token VOTRE_TOKEN
# Combiner plusieurs options
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints
Gestion des Modèles
# Lister tous les modèles dans le chemin par défaut
comfy model list
# Lister les modèles dans un chemin spécifique
comfy model list --relative-path models/loras
# Supprimer des modèles spécifiés
comfy model remove --model-names "model1.safetensors,model2.ckpt"
# Supprimer des modèles d'un chemin spécifique
comfy model remove --relative-path models/checkpoints --model-names "old_model.ckpt"
Sources de Modèles Prises en Charge
- Hugging Face : Utiliser les URLs directes de fichiers
- CivitAI : Utiliser les URLs d’API de téléchargement de modèles
- Autres liens directs : Toute URL de fichier de modèle directement téléchargeable
Gestion de ComfyUI-Manager
comfy-cli peut également gérer les paramètres de ComfyUI-Manager :
# Désactiver l'interface graphique de ComfyUI-Manager (menu et serveur)
comfy manager disable-gui
# Activer l'interface graphique de ComfyUI-Manager
comfy manager enable-gui
# Effacer les actions de démarrage réservées
comfy manager clear
Informations sur l’Environnement
Voir des informations détaillées sur l’environnement ComfyUI actuel :
# Afficher les informations de l'environnement incluant le statut d'exécution, l'espace de travail, etc.
comfy env
# Vérifier le statut des paramètres de suivi
comfy tracking status
# Désactiver le suivi d'utilisation
comfy tracking disable
# Activer le suivi d'utilisation
comfy tracking enable
Fonctionnalités Avancées
Fonctionnalité Bêta : comfy-lock.yaml
comfy-cli prend en charge l’utilisation de fichiers comfy-lock.yaml
pour gérer les dépendances de projet :
basic:
models:
- model: [Nom du Modèle]
url: [URL source du modèle, ex., https://huggingface.co/...]
paths: [Liste des chemins de modèle]
- path: [Chemin du modèle]
- path: [Chemin du modèle]
hashes: [Hachages du modèle]
- hash: [Valeur de hachage]
type: [AutoV1, AutoV2, SHA256, CRC32, Blake3]
type: [Type de modèle, ex., diffuser, lora, etc.]
# Compatible avec les instantanés .yaml de ComfyUI-Manager
custom_nodes:
comfyui: [hash de commit]
file_custom_nodes:
- disabled: [bool]
filename: [nom de fichier .py]
...
git_custom_nodes:
[git-url]:
disabled: [bool]
hash: [hash de commit]
...
Scénarios d’Usage Courants
Gestion des Environnements de Développement
# Créer un environnement de développement
comfy --workspace=~/dev/comfyui-dev install
# Créer un environnement de test
comfy --workspace=~/test/comfyui-test install
# Installer des nœuds expérimentaux dans l'environnement de développement
comfy --workspace=~/dev/comfyui-dev node install experimental-node
# Basculer rapidement vers l'environnement de test pour tester
comfy --workspace=~/test/comfyui-test launch
Gestion des Dépendances de Projet
# Créer un instantané de dépendances pour le projet
comfy node save-snapshot projet-v1.0
# Installer les dépendances du workflow du projet
comfy node install-deps --workflow=workflow-projet.json
# Restaurer vers les dépendances d'une version spécifique
comfy node restore-snapshot projet-v1.0
Gestion Automatisée des Modèles
# Télécharger en lot les modèles requis pour le projet
comfy model download --url https://huggingface.co/model1 --relative-path models/checkpoints
comfy model download --url https://huggingface.co/model2 --relative-path models/loras
# Nettoyer les anciens modèles
comfy model remove --model-names "old_model1.ckpt,old_model2.safetensors"
Dépannage
Problèmes Courants
-
Problèmes de Chemin d’Espace de Travail
# Vérifier l'espace de travail actuel comfy which # Si le chemin est incorrect, le réinitialiser comfy set-default /chemin/correct
-
Problèmes de Conflit de Nœuds
# Utiliser la fonctionnalité bisect pour localiser les problèmes comfy node bisect start # Marquer le statut normal/anormal selon les indications
-
Problèmes de Permissions
# S'assurer d'avoir des permissions suffisantes ls -la ~/comfy
Liens Connexes
- Dépôt GitHub de Comfy CLI
- Documentation Officielle de Comfy CLI
- Guide d’Installation de ComfyUI sur Linux
- Dépôt Officiel de ComfyUI