Guide Utilisateur Complet de Comfy CLI

Comfy CLI est l'outil officiel en ligne de commande pour ComfyUI — installez, gérez les nœuds et les modèles, exécutez des workflows, et appelez les modèles d'image/vidéo partenaires, le tout depuis votre terminal.

ℹ️ Note concernant les mises à jour : Pour la référence CLI la plus récente, consultez le README officiel ou docs.comfy.org.

Prérequis

Python 3.10+

Installation

Recommandé : avec pip

pip install comfy-cli

Avec pipx (environnement isolé)

pipx install comfy-cli

Avec uv (installeur Python rapide)

uv tool install comfy-cli

Auto-complétion du shell

comfy --install-completion

Désormais, comfy <TAB> développe les commandes et options.

Démarrage Rapide

# Exécuter l'assistant de configuration interactif
comfy setup

comfy setup vous guide à travers tout (routage local ou cloud, authentification et installation des compétences de l'agent) dans un seul assistant interactif. Utilisez -y pour une installation non interactive (CI/scriptée).

Sinon, installez explicitement :

comfy install

Puis lancez :

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 sur les espaces de travail

```bash
# 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 des paramètres de lancement
comfy set-default /chemin/vers/votre/espace-de-travail --launch-extras="--listen 0.0.0.0 --port 8080"

Exécution de commandes dans différents espaces de travail

Option	Cas d'utilisation
`--workspace=<chemin>`	Exécuter depuis ComfyUI installé dans l'espace de travail spécifié
`--recent`	Exécuter depuis le ComfyUI le plus récemment utilisé
`--here`	Exécuter depuis ComfyUI dans le répertoire actuel

# Lancer ComfyUI dans l'espace de travail spécifié
comfy --workspace=~/projets/projet-a launch

# Installer des nœuds dans l'espace de travail récent
comfy --recent node install ComfyUI-Impact-Pack

# Vérifier si le répertoire actuel contient ComfyUI
comfy --here which

Remarque : --workspace, --recent et --here ne peuvent pas être utilisés ensemble.

Règles de priorité des espaces de travail

Lorsqu'aucun espace de travail n'est spécifié :

Chemin par défaut défini par comfy set-default <chemin>
ComfyUI le plus récemment exécuté ou installé
ComfyUI dans le répertoire actuel

Options de Lancement

Lancement de Base

# Lancement par défaut
comfy launch

# Exécution en arrière-plan
comfy launch --background

# Arrêter l'instance en arrière-plan
comfy stop

# Lancement avec des arguments supplémentaires
comfy launch -- --cpu --listen 0.0.0.0

Configuration Réseau

comfy launch -- --listen 0.0.0.0 --port 8080

Options de Performance

comfy launch -- --cpu       # Mode CPU uniquement
comfy launch -- --lowvram   # Mode faible VRAM
comfy launch -- --novram     # Mode VRAM ultra-faible

Test des Pull Requests

# Installer une PR spécifique de ComfyUI
comfy install --pr "#1234"
comfy install --pr "https://github.com/comfyanonymous/ComfyUI/pull/1234"

# Tester une PR du frontend
comfy launch --frontend-pr "#456"
comfy launch --frontend-pr "username:branch-name"

Les builds de PR du frontend sont mis en cache pour un changement rapide. Gérer le cache :

comfy pr-cache list              # Lister les builds PR en cache
comfy pr-cache clean             # Nettoyer tous les builds en cache
comfy pr-cache clean 456         # Nettoyer le cache d'une PR spécifique

## Gestion des nœuds personnalisés

### Afficher les informations des nœuds

```bash
comfy node show all                               # All available nodes
comfy node simple-show installed                  # Simple list of installed nodes
comfy node show enabled                           # Enabled nodes only
comfy node show not-installed                     # Uninstalled nodes
comfy node show disabled                          # Disabled nodes
comfy node show all --channel recent              # Nodes from recent channel
comfy node show snapshot                          # View current snapshot info
comfy node show snapshot-list                     # List saved snapshots

Installer et mettre à jour les nœuds

comfy node install ComfyUI-Impact-Pack            # Install a custom node
comfy node update all                             # Update all nodes
comfy node update ComfyUI-Impact-Pack             # Update a specific node

Résolution rapide des dépendances

Comfy CLI offre deux façons d'utiliser uv pour une résolution plus rapide des dépendances :

Fonctionnalité	`--fast-deps`	`--uv-compile`
Portée	`comfy install`, installation/réinstallation de nœuds	Commandes de nœuds personnalisés uniquement
Résolveur	intégré à comfy-cli	Résolveur unifié ComfyUI-Manager v4.1+
Gestion des conflits	Invite interactive	Automatique avec attribution de nœud

# Fast initial install
comfy install --fast-deps

# uv-compile for custom node management (requires ComfyUI-Manager v4.1+)
comfy node install comfyui-impact-pack --uv-compile

# Run standalone (resolve all existing custom node dependencies)
comfy node uv-sync

# Make --uv-compile the default
comfy manager uv-compile-default true

Gestion des instantanés de nœuds

comfy node save-snapshot                           # Save current snapshot
comfy node restore-snapshot <snapshot_name>        # Restore a saved snapshot

Gestion des dépendances

comfy node install-deps --workflow=workflow.json   # From workflow JSON
comfy node install-deps --workflow=workflow.png    # From workflow PNG
comfy node install-deps --deps=dependencies.json   # From dep JSON file
comfy node deps-in-workflow --workflow=workflow.json --output=deps.json

Dépannage des nœuds (Bisect)

Identifier quel nœud personnalisé provoque un bug :

comfy node bisect start                            # Start bisect session
comfy node bisect good                             # Mark current state as good
comfy node bisect bad                              # Mark current state as bad
comfy node bisect reset                            # Reset session

## Générer des images sans JSON de workflow

Comfy CLI peut appeler directement des modèles d'image et de vidéo partenaires : aucun graphe de workflow requis.

```bash
comfy generate --prompt "a cat on a beach" --model flux/schnell
comfy generate --prompt "anime girl" --model stability/stable-diffusion-3.5
comfy generate --prompt "city street" --model ideogram/ideogram-v2

Fournisseurs pris en charge : Flux, Ideogram, DALL·E, Recraft, Stability, Gemini, Kling, Luma, Runway, Pika, Vidu, Hailuo, Seedance, et plus encore.

Routage vers le Cloud

Exécutez n'importe quel workflow sur Comfy Cloud (aucun GPU local requis) :

comfy launch -- --where cloud
# ou
comfy generate --model recraft/recraft-v3 --where cloud

Sortie structurée pour les agents

Chaque commande prend en charge --json pour une sortie lisible par machine : idéal pour l'intégration CI/CD et les agents d'IA.

comfy generate --prompt "a cat" --model flux/schnell --json

## Gestion des modèles

### Télécharger des modèles

```bash
# From Hugging Face
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints

# From CivitAI
comfy model download --url https://civitai.com/api/download/models/123456 --relative-path models/checkpoints

# With API token
comfy model download --url https://civitai.com/api/download/models/123456 --set-civitai-api-token YOUR_TOKEN

Les jetons API peuvent également être définis via des variables d'environnement (CIVITAI_API_TOKEN, HF_API_TOKEN), ce qui est plus sûr pour les environnements CI/CD.

Gérer les modèles

comfy model list                                  # List models in default path
comfy model list --relative-path models/loras     # List in subfolder
comfy model remove --model-names "model.safetensors"  # Remove a model

## Gestion de ComfyUI-Manager

```bash
comfy manager disable-gui                         # Désactiver l'interface graphique du Manager
comfy manager enable-gui                          # Activer l'interface graphique du Manager
comfy manager clear                               # Effacer les actions de démarrage réservées

## Informations sur l'environnement

```bash
comfy env                                         # Afficher les informations détaillées de l'environnement
comfy tracking status                             # Vérifier les paramètres de suivi
comfy tracking disable                            # Désactiver le suivi d'utilisation
comfy tracking enable                             # Activer le suivi d'utilisation

## Fonctionnalités Avancées

### comfy-lock.yaml (Bêta)

Utilisez un fichier `comfy-lock.yaml` pour gérer les dépendances du projet :

```yaml
basic:

models:
  - model: SD1.5 Base
    url: https://huggingface.co/...
    paths:
      - path: models/checkpoints
    hashes:
      - hash: abc123...
        type: SHA256
    type: checkpoint

custom_nodes:
  git_custom_nodes:
    https://github.com/user/ComfyUI-Node:
      disabled: false
      hash: a1b2c3d...

## Scénarios d'utilisation courants

### Gestion des environnements de développement

```bash
# Créer un espace de travail pour un développement stable
comfy --workspace=~/dev/comfyui-stable install

# Créer un espace de travail pour des fonctionnalités expérimentales
comfy --workspace=~/dev/comfyui-experimental install

# Installer des nœuds expérimentaux
comfy --workspace=~/dev/comfyui-experimental node install ComfyUI-AnimateDiff-Evolved

Gestion des dépendances de projet

# Créer un instantané pour un projet
comfy node save-snapshot my-project-v1

# Restaurer les dépendances du projet
comfy node restore-snapshot my-project-v1

# Installer les dépendances du workflow
comfy node install-deps --workflow=project.json

## Dépannage

### Problèmes courants

1. **Problèmes de chemin d'espace de travail**
   ```bash
   comfy which              # Vérifier l'espace de travail actuel
   comfy set-default /path  # Réinitialiser vers le bon chemin

Conflits de nœuds

comfy node bisect start  # Utiliser bisect pour localiser le nœud problématique

Problèmes de permissions

ls -la ~/comfy           # Vérifier les permissions du répertoire