Cómo Instalar ComfyUI en Linux
Existen dos formas principales de instalar ComfyUI en Linux:
- Instalación usando Comfy CLI (Recomendado) - El método más simple y rápido
- Instalación desde el código fuente de ComfyUI - Método de instalación manual tradicional
Este tutorial cubrirá ambos métodos de instalación en detalle, con énfasis en recomendar la instalación con Comfy CLI.
Método 1: Instalar ComfyUI usando Comfy CLI (Recomendado)
Comfy CLI es la herramienta oficial de línea de comandos proporcionada por ComfyUI, que simplifica enormemente el proceso de instalación y gestión de ComfyUI.
Paso 1: Preparación del Entorno del Sistema
1. Asegurar el Entorno de Python
ComfyUI requiere Python 3.9 o superior. Verifica tu versión de Python:
python3 --version
Si Python no está instalado o la versión es muy antigua, instálalo siguiendo estos pasos:
Sistemas Ubuntu/Debian:
sudo apt update
sudo apt install python3 python3-pip python3-venv
Sistemas CentOS/RHEL/Fedora:
# CentOS/RHEL
sudo yum install python3 python3-pip
# Or Fedora
sudo dnf install python3 python3-pip
Arch Linux:
sudo pacman -S python python-pip
2. Instalar Git (si no está instalado)
# Ubuntu/Debian
sudo apt install git
# CentOS/RHEL
sudo yum install git
# Fedora
sudo dnf install git
# Arch Linux
sudo pacman -S git
3. Crear Entorno Virtual (Recomendado)
Usar un entorno virtual puede evitar problemas de conflictos de paquetes:
# Crear un entorno virtual llamado comfy-env
python3 -m venv comfy-env
# Activar el entorno virtual
source comfy-env/bin/activate
Nota: Necesitas activar el entorno virtual cada vez antes de usar ComfyUI. Para salir del entorno virtual, usa el comando
deactivate
.
Paso 2: Instalar Comfy CLI
Instala comfy-cli en el entorno virtual activado:
pip install comfy-cli
Configurar Autocompletado de Línea de Comandos (Opcional)
Para obtener una mejor experiencia de usuario, puedes habilitar el autocompletado de línea de comandos:
comfy --install-completion
Paso 3: Instalar ComfyUI
Instalar ComfyUI con comfy-cli es muy simple, solo requiere un comando:
comfy install
Este comando:
- Descargará e instalará la última versión de ComfyUI
- Instalará automáticamente ComfyUI-Manager (gestor de nodos)
- Configurará la estructura básica del proyecto
Opciones de Instalación
Puedes usar las siguientes opciones para personalizar la instalación:
# Instalar en la ubicación predeterminada ~/comfy
comfy install
# Instalar en directorio específico
comfy --workspace=/ruta/a/tu/espacio-de-trabajo install
# Operar en ComfyUI existente en directorio actual (principalmente para actualizaciones)
comfy --here install
# Operar en el ComfyUI ejecutado o instalado más recientemente
comfy --recent install
# Instalar solo ComfyUI, sin ComfyUI-Manager
comfy install --skip-manager
Verificar Ruta de Instalación
Puedes usar los siguientes comandos para verificar el espacio de trabajo actual:
# Verificar espacio de trabajo predeterminado
comfy which
# Verificar espacio de trabajo para opciones específicas
comfy --recent which
comfy --here which
Paso 4: Instalar Soporte de GPU
GPU NVIDIA (CUDA)
Si estás usando una GPU NVIDIA, necesitas instalar soporte CUDA:
# Instalar PyTorch con soporte CUDA
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
Nota: Por favor elige la versión correspondiente de PyTorch basada en tu versión de CUDA. Visita el sitio web de PyTorch para los comandos de instalación más recientes.
GPU AMD (ROCm)
Si estás usando una GPU AMD:
# Instalar PyTorch con soporte ROCm
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0
Solo CPU
Si ejecutas solo con CPU:
# Instalar versión CPU de PyTorch
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
Paso 5: Ejecutar ComfyUI
Después de completar la instalación, ejecuta ComfyUI:
comfy launch
Por defecto, ComfyUI se ejecutará en http://localhost:8188
.
Opciones Comunes de Ejecución
# Ejecutar en segundo plano
comfy launch --background
# Especificar dirección de escucha y puerto
comfy launch -- --listen 0.0.0.0 --port 8080
# Usar modo CPU
comfy launch -- --cpu
# Modo VRAM baja
comfy launch -- --lowvram
# Detener instancia en segundo plano
comfy stop
Método 2: Instalar desde Código Fuente de ComfyUI
Si prefieres el método de instalación tradicional, también puedes instalar directamente desde el código fuente:
1. Clonar Repositorio de ComfyUI
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
2. Crear Entorno Virtual
python3 -m venv venv
source venv/bin/activate
3. Instalar Dependencias
pip install -r requirements.txt
4. Instalar Soporte de GPU
Instala la versión correspondiente de PyTorch basada en tu tipo de GPU (consulta los pasos anteriores).
5. Ejecutar ComfyUI
python main.py
Configuración Post-Instalación
Instalar Modelos Base
ComfyUI requiere modelos base para funcionar correctamente. Puedes:
- Descargar modelos desde Hugging Face
- Colocar archivos de modelos en el directorio
models/checkpoints/
- Descargar usando comfy-cli:
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints
Solución de Problemas
Problemas Comunes
1. Problemas de Permisos
Si encuentras problemas de permisos, asegúrate de tener permisos suficientes para escribir en el directorio de instalación:
# Si usas el directorio predeterminado, asegúrate de que el directorio ~/comfy sea escribible
ls -la ~/comfy
2. Problemas de Versión de Python
Asegúrate de estar usando la versión correcta de Python:
python3 --version # Debería ser 3.9 o superior
3. Problemas de Conexión de Red
Si las descargas son lentas, intenta usar un espejo doméstico:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comfy-cli
4. Problemas de Detección de GPU
Verifica si la GPU es reconocida correctamente:
import torch
print(torch.cuda.is_available()) # GPU NVIDIA
print(torch.version.cuda) # Versión CUDA
Resumen
Usar Comfy CLI es la mejor manera de instalar ComfyUI en Linux, ofreciendo:
- Proceso de instalación simple: Instalación completa con un comando
- Gestión completa de dependencias: Maneja automáticamente todas las dependencias
- Soporte multi-espacio de trabajo: Puede gestionar múltiples instancias de ComfyUI
- Compatibilidad multiplataforma: Funciona correctamente en Windows, macOS y Linux
Si eres nuevo en ComfyUI, recomendamos encarecidamente usar Comfy CLI para instalación y gestión.
Próximos Pasos
Después de la instalación, puedes:
- 📖 Consultar la Guía Completa de Usuario de Comfy CLI para aprender características más avanzadas
- 🎯 Comenzar tu primer flujo de trabajo de ComfyUI
- 🔧 Instalar y gestionar nodos personalizados
- 📦 Descargar y gestionar modelos
Enlaces Relacionados
- Guía Completa de Usuario de Comfy CLI
- Repositorio GitHub de Comfy CLI
- Documentación Oficial de Comfy CLI
- Repositorio Oficial de ComfyUI
- Guía de Instalación de PyTorch