Skip to content
Follow me on X
•ComfyUI Wiki
Guide d'Installation1. Installer ComfyUI1.4 Linux
Aucun article pour le moment. Revenez plus tard !

Comment Installer ComfyUI sur Linux

⚠️ Avis Important : Cette documentation peut ne pas toujours être à jour. Veuillez vous référer en priorité au Dépôt Officiel ComfyUI pour les instructions d’installation les plus récentes et les plus précises, en particulier pour les configurations spécifiques telles que le support AMD GPU. La documentation officielle est la meilleure source d’informations à jour.

Il existe deux façons principales d’installer ComfyUI sur Linux :

  1. Installation avec Comfy CLI (Recommandé) - La méthode la plus simple et la plus rapide
  2. Installation depuis le code source de ComfyUI - Méthode d’installation manuelle traditionnelle

Ce tutoriel couvre les deux méthodes d’installation en détail, en mettant l’accent sur la recommandation d’installation avec Comfy CLI.

Méthode 1 : Installer ComfyUI avec Comfy CLI (Recommandé)

Comfy CLI est l’outil officiel en ligne de commande fourni par ComfyUI, qui simplifie grandement le processus d’installation et de gestion de ComfyUI.

Étape 1 : Préparation de l’Environnement Système

1. S’assurer de l’Environnement Python

ComfyUI nécessite Python 3.12 ou supérieur (Python 3.13 est recommandé). Vérifiez votre version de Python :

python3 --version

Si Python n’est pas installé ou si la version est trop ancienne, installez-le en suivant ces étapes :

Systèmes Ubuntu/Debian :

sudo apt update
sudo apt install python3 python3-pip python3-venv

Systèmes CentOS/RHEL/Fedora :

# CentOS/RHEL
sudo yum install python3 python3-pip
# Ou Fedora
sudo dnf install python3 python3-pip

Arch Linux :

sudo pacman -S python python-pip

2. Installer Git (si non installé)

# Ubuntu/Debian
sudo apt install git
 
# CentOS/RHEL
sudo yum install git
 
# Fedora
sudo dnf install git
 
# Arch Linux
sudo pacman -S git

3. Créer un Environnement Virtuel (Recommandé)

L’utilisation d’un environnement virtuel peut éviter les problèmes de conflit de paquets :

# Créer un environnement virtuel nommé comfy-env
python3 -m venv comfy-env
 
# Activer l'environnement virtuel
source comfy-env/bin/activate

Note : Vous devez activer l’environnement virtuel à chaque fois avant d’utiliser ComfyUI. Pour sortir de l’environnement virtuel, utilisez la commande deactivate.

Étape 2 : Installer Comfy CLI

Installez comfy-cli dans l’environnement virtuel activé :

pip install comfy-cli

Configurer l’Auto-complétion en Ligne de Commande (Optionnel)

Pour obtenir une meilleure expérience utilisateur, vous pouvez activer l’auto-complétion en ligne de commande :

comfy --install-completion

Étape 3 : Installer ComfyUI

Installer ComfyUI avec comfy-cli est très simple, ne nécessitant qu’une seule commande :

comfy install

Cette commande va :

  • Télécharger et installer la dernière version de ComfyUI
  • Installer automatiquement ComfyUI-Manager (gestionnaire de nœuds)
  • Configurer la structure de projet de base

Options d’Installation

Vous pouvez utiliser les options suivantes pour personnaliser l’installation :

# Installer à l'emplacement par défaut ~/comfy
comfy install
 
# Installer dans un répertoire spécifique
comfy --workspace=/chemin/vers/votre/espace-de-travail install
 
# Opérer sur ComfyUI existant dans le répertoire actuel (principalement pour les mises à jour)
comfy --here install
 
# Opérer sur le ComfyUI exécuté ou installé le plus récemment
comfy --recent install
 
# Installer seulement ComfyUI, sans ComfyUI-Manager
comfy install --skip-manager

Vérifier le Chemin d’Installation

Vous pouvez utiliser les commandes suivantes pour vérifier l’espace de travail actuel :

# Vérifier l'espace de travail par défaut
comfy which
 
# Vérifier l'espace de travail pour les options spécifiées
comfy --recent which
comfy --here which

Étape 4 : Installer le Support GPU

GPU NVIDIA (CUDA)

Si vous utilisez un GPU NVIDIA, vous devez installer le support CUDA :

# Installer PyTorch avec support CUDA
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

Note : Veuillez choisir la version PyTorch correspondante en fonction de votre version CUDA. Visitez le site web PyTorch pour les commandes d’installation les plus récentes.

GPU AMD (ROCm)

Si vous utilisez un GPU AMD, vous devez installer la version ROCm de PyTorch :

# Installer PyTorch avec support ROCm
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4

Note : Pour les dernières commandes d’installation ROCm, visitez le site web PyTorch.

Pour les GPU AMD non officiellement supportés par ROCm

Si votre GPU AMD n’est pas officiellement supporté par ROCm (comme RX 6700, RX 6600, RX 7600, etc.), vous pouvez utiliser des variables d’environnement pour forcer l’activation du support :

Pour les GPU d’architecture RDNA2 (comme RX 6700, RX 6600, etc.) :

HSA_OVERRIDE_GFX_VERSION=10.3.0 comfy launch

Pour les GPU d’architecture RDNA3 (comme RX 7600, etc.) :

HSA_OVERRIDE_GFX_VERSION=11.0.0 comfy launch

Si vous utilisez la méthode d’installation depuis le code source :

# GPU RDNA2
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py
 
# GPU RDNA3
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py
Conseils d’optimisation des performances GPU AMD

Sur les versions récentes de PyTorch, vous pouvez essayer d’activer le mécanisme d’attention expérimental à mémoire efficace pour améliorer les performances (activé par défaut sur les GPU RDNA3) :

TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1 comfy launch -- --use-pytorch-cross-attention

Vous pouvez également essayer de définir la variable d’environnement suivante, qui peut améliorer la vitesse (mais le premier lancement sera plus lent) :

PYTORCH_TUNABLEOP_ENABLED=1 comfy launch

GPU Intel

Si vous utilisez un GPU Intel :

# Installer PyTorch avec support Intel XPU
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

CPU Seulement

Si vous exécutez avec CPU seulement :

# Installer la version CPU de PyTorch
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu

Étape 5 : Lancer ComfyUI

Après l’installation terminée, lancez ComfyUI :

comfy launch

Par défaut, ComfyUI s’exécutera sur http://localhost:8188.

Options de Lancement Communes

# Spécifier l'adresse d'écoute et le port
comfy launch -- --listen 0.0.0.0 --port 8080
 
# Utiliser le mode CPU
comfy launch -- --cpu
 
# Mode VRAM faible
comfy launch -- --lowvram
 
# Mode VRAM ultra-faible
comfy launch -- --novram

Note : Le paramètre --background peut ne plus être supporté dans certaines versions de ComfyUI. Si vous devez exécuter en arrière-plan, envisagez d’utiliser des outils au niveau du système tels que nohup ou screen.

Méthode 2 : Installer depuis le Code Source de ComfyUI

Si vous préférez la méthode d’installation traditionnelle, vous pouvez également installer directement depuis le code source :

1. Cloner le Dépôt ComfyUI

git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

2. Créer un Environnement Virtuel

python3 -m venv venv
source venv/bin/activate

3. Installer les Dépendances

pip install -r requirements.txt

4. Installer le Support GPU

Installez la version PyTorch correspondante en fonction de votre type de GPU (référez-vous aux étapes ci-dessus).

5. Lancer ComfyUI

python main.py

Si vous utilisez un GPU AMD et rencontrez des problèmes, veuillez vous référer à la section de dépannage GPU AMD ci-dessous.

Configuration Post-Installation

Installer les Modèles de Base

ComfyUI nécessite des modèles de base pour fonctionner correctement. Vous pouvez :

  1. Télécharger les modèles depuis Hugging Face
  2. Placer les fichiers de modèles dans le répertoire models/checkpoints/
  3. Télécharger en utilisant comfy-cli :
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints

Dépannage

Problèmes Courants

1. Problèmes de Permissions

Si vous rencontrez des problèmes de permissions, assurez-vous d’avoir des permissions suffisantes pour écrire dans le répertoire d’installation :

# Si vous utilisez le répertoire par défaut, assurez-vous que le répertoire ~/comfy est accessible en écriture
ls -la ~/comfy

2. Problèmes de Version Python

Assurez-vous d’utiliser la version Python correcte :

python3 --version  # Devrait être 3.9 ou supérieur

3. Problèmes de Connexion Réseau

Si les téléchargements sont lents, essayez d’utiliser un miroir domestique :

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comfy-cli

4. Problèmes de Détection GPU

Vérifiez si le GPU est correctement reconnu :

import torch
print(torch.cuda.is_available())  # GPU NVIDIA
print(torch.version.cuda)         # Version CUDA

5. Problèmes GPU AMD

Problème : Message d’erreur indiquant que le pilote NVIDIA est introuvable au démarrage

Cause : Même après avoir installé la version ROCm de PyTorch, si le système détecte des pilotes NVIDIA ou une configuration incorrecte, cette erreur peut toujours se produire.

Solutions :

  1. Vérifiez que vous avez installé la bonne version ROCm de PyTorch :

    python -c "import torch; print(torch.__version__)"

  2. Vérifiez si vous êtes dans un environnement virtuel :

    # Assurez-vous que l'environnement virtuel est activé
source comfy-env/bin/activate  # ou votre chemin d'environnement virtuel

  3. Pour les GPU AMD non officiellement supportés, utilisez des variables d’environnement :

    # GPU RDNA2
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py
 
# GPU RDNA3
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py

  4. Si le problème persiste, essayez de démarrer en mode CPU :

    python main.py --cpu

  5. Référez-vous à la documentation officielle : Pour plus d’informations sur les GPU AMD, veuillez vous référer à la section GPU AMD du dépôt officiel ComfyUI.

6. Problèmes de Chemin d’Environnement Virtuel

Problème : Impossible de trouver le chemin de l’environnement virtuel après avoir fermé ComfyUI

Solutions :

  1. Mémorisez le chemin complet de l’environnement virtuel :

    # Lors de la création de l'environnement virtuel, utilisez un chemin absolu ou mémorisez le chemin relatif
cd ~/your-workspace
python3 -m venv comfy-env

  2. Activez l’environnement virtuel avant chaque utilisation :

    # Naviguez vers le répertoire de l'environnement virtuel
cd ~/your-workspace
source comfy-env/bin/activate

  3. Utilisez comfy-cli pour la gestion (recommandé) : comfy-cli gère automatiquement les environnements virtuels, aucune activation manuelle nécessaire.

  4. Créez un script de démarrage :

    # Créer start-comfy.sh
#!/bin/bash
cd ~/your-workspace
source comfy-env/bin/activate
comfy launch

    Puis ajoutez les permissions d’exécution avec chmod +x start-comfy.sh.

7. Problèmes d’Installation PyTorch

Problème : Téléchargement PyTorch interrompu (Killed)

Solutions :

  1. Augmentez l’espace d’échange système (si la mémoire est insuffisante)
  2. Utilisez un miroir domestique : 
    pip install -i https://pypi.tuna.tsinghua.edu.cn/simple torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
  3. Installez étape par étape : 
    pip install torch --index-url https://download.pytorch.org/whl/cu124
pip install torchvision --index-url https://download.pytorch.org/whl/cu124
pip install torchaudio --index-url https://download.pytorch.org/whl/cu124

Résumé

Utiliser Comfy CLI est la meilleure façon d’installer ComfyUI sur Linux, offrant :

  • Processus d’installation simple : Installation complète avec une commande
  • Gestion complète des dépendances : Gère automatiquement toutes les dépendances
  • Support multi-espace de travail : Peut gérer plusieurs instances ComfyUI
  • Compatibilité multiplateforme : Fonctionne correctement sur Windows, macOS et Linux

Si vous êtes nouveau à ComfyUI, nous recommandons fortement d’utiliser Comfy CLI pour l’installation et la gestion.

Prochaines Étapes

Après l’installation, vous pouvez :

  • 📖 Consulter le Guide Utilisateur Complet de Comfy CLI pour apprendre des fonctionnalités plus avancées
  • 🎯 Commencer votre premier workflow ComfyUI
  • 🔧 Installer et gérer des nœuds personnalisés
  • 📦 Télécharger et gérer des modèles

Liens Connexes

1.3 Mac1.5 Run on Cloud