Skip to content
Follow me on X
•ComfyUI Wiki
Guía de Instalación1. Instalar ComfyUI1.4 Linux

SVI 2.0 Pro Lanzado - Generación de Video de Longitud Infinita con Soporte para Wan 2.2

29/12/2025

Cómo Instalar ComfyUI en Linux

⚠️ Aviso Importante: Esta documentación puede no estar siempre actualizada. Por favor, consulte primero el Repositorio Oficial de ComfyUI para obtener las instrucciones de instalación más recientes y precisas, especialmente para configuraciones específicas como el soporte de GPU AMD. La documentación oficial es la mejor fuente de información actualizada.

Existen dos formas principales de instalar ComfyUI en Linux:

  1. Instalación usando Comfy CLI (Recomendado) - El método más simple y rápido
  2. 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.12 o superior (se recomienda Python 3.13). 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 --extra-index-url https://download.pytorch.org/whl/cu130

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, necesitas instalar la versión ROCm de PyTorch:

# Instalar PyTorch con soporte ROCm
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4

Nota: Para los comandos de instalación ROCm más recientes, visita el sitio web de PyTorch.

Para GPU AMD no oficialmente soportadas por ROCm

Si tu GPU AMD no está oficialmente soportada por ROCm (como RX 6700, RX 6600, RX 7600, etc.), puedes usar variables de entorno para forzar la habilitación del soporte:

Para GPU de arquitectura RDNA2 (como RX 6700, RX 6600, etc.):

HSA_OVERRIDE_GFX_VERSION=10.3.0 comfy launch

Para GPU de arquitectura RDNA3 (como RX 7600, etc.):

HSA_OVERRIDE_GFX_VERSION=11.0.0 comfy launch

Si usas el método de instalación desde código fuente:

# GPU RDNA2
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py
 
# GPU RDNA3
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py
Consejos de Optimización de Rendimiento para GPU AMD

En versiones recientes de PyTorch, puedes intentar habilitar el mecanismo experimental de atención eficiente en memoria para mejorar el rendimiento (habilitado por defecto en GPU RDNA3):

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

También puedes intentar establecer la siguiente variable de entorno, que puede mejorar la velocidad (pero la primera ejecución será más lenta):

PYTORCH_TUNABLEOP_ENABLED=1 comfy launch

GPU Intel

Si estás usando una GPU Intel:

# Instalar PyTorch con soporte Intel XPU
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

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

# 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
 
# Modo VRAM ultra baja
comfy launch -- --novram

Nota: El parámetro --background puede dejar de estar soportado en algunas versiones de ComfyUI. Si necesitas ejecutar en segundo plano, considera usar herramientas a nivel del sistema como nohup o screen.

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

Si estás usando una GPU AMD y encuentras problemas, por favor consulta la sección de solución de problemas de GPU AMD a continuación.

Configuración Post-Instalación

Instalar Modelos Base

ComfyUI requiere modelos base para funcionar correctamente. Puedes:

  1. Descargar modelos desde Hugging Face
  2. Colocar archivos de modelos en el directorio models/checkpoints/
  3. 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

5. Problemas de GPU AMD

Problema: Mensaje de error sobre que no se encuentra el controlador NVIDIA al iniciar

Causa: Incluso después de instalar la versión ROCm de PyTorch, si el sistema detecta controladores NVIDIA o configuración incorrecta, este error aún puede ocurrir.

Soluciones:

  1. Verifica que tienes instalada la versión correcta de ROCm de PyTorch:

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

  2. Verifica si estás en un entorno virtual:

    # Asegúrate de que el entorno virtual esté activado
source comfy-env/bin/activate  # o tu ruta de entorno virtual

  3. Para GPU AMD no oficialmente soportadas, usa variables de entorno:

    # 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 el problema persiste, intenta iniciar en modo CPU:

    python main.py --cpu

  5. Consulta la documentación oficial: Para más información sobre GPU AMD, por favor consulta la sección de GPU AMD del repositorio oficial de ComfyUI.

6. Problemas de Ruta de Entorno Virtual

Problema: No se puede encontrar la ruta del entorno virtual después de cerrar ComfyUI

Soluciones:

  1. Recuerda la ruta completa del entorno virtual:

    # Al crear el entorno virtual, usa una ruta absoluta o recuerda la ruta relativa
cd ~/your-workspace
python3 -m venv comfy-env

  2. Activa el entorno virtual antes de cada uso:

    # Navega al directorio del entorno virtual
cd ~/your-workspace
source comfy-env/bin/activate

  3. Usa comfy-cli para la gestión (recomendado): comfy-cli gestiona automáticamente los entornos virtuales, no se necesita activación manual.

  4. Crea un script de inicio:

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

    Luego agrega permisos de ejecución con chmod +x start-comfy.sh.

7. Problemas de Instalación de PyTorch

Problema: Descarga de PyTorch interrumpida (Killed)

Soluciones:

  1. Aumenta el espacio de intercambio del sistema (si la memoria es insuficiente)
  2. Usa un espejo doméstico: 
    pip install -i https://pypi.tuna.tsinghua.edu.cn/simple torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu130
  3. Instala paso a paso: 
    pip install torch --index-url https://download.pytorch.org/whl/cu130
pip install torchvision --index-url https://download.pytorch.org/whl/cu130
pip install torchaudio --index-url https://download.pytorch.org/whl/cu130

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

1.3 Mac1.5 Ejecutar en la Nube