Comment Installer ComfyUI sur Linux
Il existe deux façons principales d’installer ComfyUI sur Linux :
- Installation avec Comfy CLI (Recommandé) - La méthode la plus simple et la plus rapide
- 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.9 ou supérieur. 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 --index-url https://download.pytorch.org/whl/cu124
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 :
# Installer PyTorch avec support ROCm
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0
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
# Exécuter en arrière-plan
comfy launch --background
# 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
# Arrêter l'instance en arrière-plan
comfy stop
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
Configuration Post-Installation
Installer les Modèles de Base
ComfyUI nécessite des modèles de base pour fonctionner correctement. Vous pouvez :
- Télécharger les modèles depuis Hugging Face
- Placer les fichiers de modèles dans le répertoire
models/checkpoints/
- 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
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
- Guide Utilisateur Complet de Comfy CLI
- Dépôt GitHub de Comfy CLI
- Documentation Officielle de Comfy CLI
- Dépôt Officiel de ComfyUI
- Guide d’Installation PyTorch