Cómo solucionar problemas de ComfyUI

Recibimos muchos reportes de problemas y notamos que la mayoría de los enviados están relacionados con nodos personalizados. Por eso, asegúrate de haber leído la guía de solución de problemas de nodos personalizados antes de enviar un reporte de error, para confirmar que el problema no se debe a fallas del núcleo de ComfyUI.

Guía de solución de problemas de nodos personalizados

Consulta cómo solucionar los problemas causados por nodos personalizados.

Problemas comunes y soluciones rápidas

Antes de entrar en la solución de problemas detallada, prueba estas soluciones comunes:

ComfyUI no se inicia

Síntomas: la aplicación se bloquea al iniciar, se queda en pantalla negra o no termina de cargar Soluciones rápidas:

Verifica los requisitos del sistema - Asegúrate de que tu sistema cumpla los requisitos mínimos
Actualiza los controladores de la GPU - Descarga los controladores más recientes de NVIDIA/AMD/Intel

La generación falla o produce errores

Síntomas: aparece el diálogo “Prompt execution failed” con el botón “Show report” y el flujo de trabajo deja de ejecutarse Soluciones rápidas:

Haz clic en “Show report” - Lee el mensaje de error detallado para identificar el problema concreto
Comprueba si es un problema de nodos personalizados - Sigue nuestra guía de solución de problemas de nodos personalizados
Verifica los archivos de modelo - Consulta la documentación de modelos para configurar los modelos
Revisa el uso de VRAM - Cierra otras aplicaciones que estén usando la memoria de la GPU

Rendimiento lento

Síntomas: tiempos de generación muy lentos, el sistema se congela, errores de memoria insuficiente Soluciones rápidas:

Reduce la resolución o el tamaño del lote - Disminuye el tamaño de la imagen o el número de imágenes
Usa las opciones de optimización de memoria - Consulta la sección de optimización de rendimiento de más abajo
Cierra las aplicaciones innecesarias - Libera RAM y VRAM
Revisa el uso de CPU/GPU - Usa el Administrador de tareas para identificar los cuellos de botella

Comandos de optimización de rendimiento: Para sistemas con poca VRAM:

# Low VRAM mode (uses cpu for text encoder)
python main.py --lowvram

# CPU mode (very slow but works with any hardware, only use as absolute last resort)
python main.py --cpu

Para obtener un mejor rendimiento:

# Disable previews (saves VRAM and processing)
python main.py --preview-method none

# Use optimized attention mechanisms
python main.py --use-pytorch-cross-attention
python main.py --use-flash-attention

# Async weight offloading
python main.py --async-offload

Para la gestión de memoria:

# Reserve specific VRAM amount for OS (in GB)
python main.py --reserve-vram 2

# Disable smart memory management
python main.py --disable-smart-memory

# Use different caching strategies
python main.py --cache-none      # Less RAM usage, but slower
python main.py --cache-lru 10    # Cache 10 results, faster
python main.py --cache-classic   # Use the old style (aggressive) caching. 

Problemas específicos de la instalación

Problemas de la aplicación de escritorio

Para una solución de problemas completa de la instalación de escritorio, consulta la Guía de instalación de escritorio.

Windows
macOS
Linux

Dispositivo no compatible: Comfy Desktop para Windows solo admite GPUs NVIDIA con CUDA. Usa ComfyUI Portable o la instalación manual para otras GPUs
La instalación falla: ejecuta el instalador como administrador y asegúrate de tener al menos 15 GB de espacio en disco
Página de mantenimiento: revisa la configuración de espejos si las descargas fallan
Modelos faltantes: los modelos no se copian durante la migración, solo se enlazan. Verifica las rutas de los modelos

Problemas de la instalación manual

Es posible que la documentación esté ligeramente desactualizada. Si surge algún problema, verifica manualmente si existe una versión estable más reciente de PyTorch o de cualquiera de las bibliotecas indicadas. Consulta recursos como la matriz de instalación de PyTorch o el sitio web de ROCm.

Conflictos de versión de Python:

# Check Python version (3.9+ required, 3.12 recommended)
python --version

# Use virtual environment (recommended)
python -m venv comfyui_env
source comfyui_env/bin/activate  # Linux/Mac
comfyui_env\Scripts\activate     # Windows

Fallos al instalar paquetes:

# Update pip first
python -m pip install --upgrade pip

# Install dependencies
pip install -r requirements.txt

# For NVIDIA GPUs (CUDA 13.0)
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

# For AMD GPUs (Linux only - ROCm 7.2)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

Problemas específicos de Linux

Errores de LD_LIBRARY_PATH: Síntomas comunes:

“libcuda.so.1: cannot open shared object file”
“libnccl.so: cannot open shared object file”
“ImportError: libnvinfer.so.X: cannot open shared object file”

Soluciones:

Instalaciones modernas de PyTorch (lo más común):

# For virtual environments with NVIDIA packages
export LD_LIBRARY_PATH=$VIRTUAL_ENV/lib/python3.12/site-packages/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH

# For conda environments
export LD_LIBRARY_PATH=$CONDA_PREFIX/lib/python3.12/site-packages/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH

# Or find your Python site-packages automatically
PYTHON_PATH=$(python -c "import site; print(site.getsitepackages()[0])")
export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH

# You may also need other NVIDIA libraries
export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/cuda_runtime/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/cublas/lib:$LD_LIBRARY_PATH

Averigua qué bibliotecas tienes:

# Check installed NVIDIA packages
python -c "import site; import os; nvidia_path=os.path.join(site.getsitepackages()[0], 'nvidia'); print('NVIDIA libs:', [d for d in os.listdir(nvidia_path) if os.path.isdir(os.path.join(nvidia_path, d))] if os.path.exists(nvidia_path) else 'Not found')"

# Find missing libraries that PyTorch needs
python -c "import torch; print(torch.__file__)"
ldd $(python -c "import torch; print(torch.__file__.replace('__init__.py', 'lib/libtorch_cuda.so'))")

Configúralo de forma permanente para tu entorno:

# For virtual environments, add to activation script
echo 'export LD_LIBRARY_PATH=$VIRTUAL_ENV/lib/python*/site-packages/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH' >> $VIRTUAL_ENV/bin/activate

# For conda environments
conda env config vars set LD_LIBRARY_PATH=$CONDA_PREFIX/lib/python*/site-packages/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH

# For global bashrc (adjust Python version as needed)
echo 'export LD_LIBRARY_PATH=$(python -c "import site; print(site.getsitepackages()[0])")/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH' >> ~/.bashrc

Alternativa: usa ldconfig:

# Check current library cache
ldconfig -p | grep cuda
ldconfig -p | grep nccl

# If missing, add library paths (requires root)
sudo echo "/usr/local/cuda/lib64" > /etc/ld.so.conf.d/cuda.conf
sudo ldconfig

Depura la carga de bibliotecas:

# Verbose library loading to see what's missing
LD_DEBUG=libs python main.py 2>&1 | grep "looking for"

# Check PyTorch CUDA availability
python -c "import torch; print('CUDA available:', torch.cuda.is_available()); print('CUDA version:', torch.version.cuda)"

Problemas relacionados con los modelos

Para una resolución de problemas de modelos completa, que incluye desajustes de arquitectura, modelos faltantes y errores de carga, consulta la página dedicada Problemas de modelos.

Problemas de red y API

Nodos asociados que no funcionan

Síntomas: las llamadas a la API fallan, errores de tiempo de espera, cuota excedida Soluciones:

Verifica la validez de la clave API - Comprueba las claves en configuraciones de usuario
Revisa los créditos de la cuenta - Asegúrate de tener suficientes créditos de API
Verifica la conexión a internet - Prueba con otros servicios en línea
Revisa el estado del servicio - Es posible que el proveedor esté sufriendo una interrupción

Problemas de conexión

Síntomas: “Failed to connect to server”, errores de tiempo de espera Soluciones:

Revisa la configuración del firewall - Permite que ComfyUI pase a través del firewall
Prueba con otro puerto - El predeterminado es 8188, prueba con 8189 o 8190
Desactiva la VPN temporalmente - La VPN puede estar bloqueando las conexiones
Revisa la configuración del proxy - Desactiva el proxy si no es necesario

Problemas del frontend

“El paquete de frontend o de plantillas no está actualizado”:

# Después de actualizar ComfyUI vía Git, actualiza las dependencias del frontend
pip install -r requirements.txt

“No se encuentra el nodo personalizado”:

Desactiva la validación de nodos en las configuraciones de ComfyUI

“Aviso de error sobre un flujo de trabajo que no pasa la validación”:

Desactiva temporalmente la validación del flujo de trabajo en las configuraciones
Reporta el problema al equipo de ComfyUI

Problemas de inicio de sesión fuera de localhost:

El inicio de sesión normal solo funciona cuando accedes desde localhost
Para acceso por LAN o remoto: genera una clave API en platform.comfy.org/login
Usa la clave API en el diálogo de inicio de sesión o con el argumento de línea de comandos --api-key

Problemas específicos del hardware

Problemas con GPU NVIDIA

Error “Torch not compiled with CUDA enabled”:

# First uninstall torch
pip uninstall torch

# Install stable PyTorch with CUDA 13.0
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130

# For nightly builds (might have performance improvements)
pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu132

# Verify CUDA support
python -c "import torch; print(torch.cuda.is_available())"

GPU no detectada:

# Check if GPU is visible
nvidia-smi

# Check driver version and CUDA compatibility
nvidia-smi --query-gpu=driver_version --format=csv

GPUs Blackwell (sm_103): la generación falla en la primera capa de atención: En las GPUs NVIDIA de generación Blackwell, la atención de producto escalar escalada (SDPA) que PyTorch usa de forma predeterminada puede seleccionar el backend de cuDNN, que no tiene ningún plan válido para esta arquitectura:

cuDNN Frontend error: No valid execution plans built

Con FLUX esto afecta al primer bloque de atención de la UNet, así que nunca se llega a producir ninguna imagen.

# Use a hand-written attention implementation that bypasses SDPA and cuDNN
python main.py --use-split-cross-attention

# Blackwell also requires a CUDA 12.8 or newer PyTorch build;
# builds compiled against cu121 will not run on these cards at all

Desactivar el backend cuDNN de SDPA mediante código antes del arranque — por ejemplo, llamando a torch.backends.cuda.enable_cudnn_sdp(False) desde un sitecustomize.py — no funciona, porque el flag no se conserva a través de la inicialización de CUDA. El flag de arranque es la solución fiable.

Esta entrada se añadió en el PR #1491.

Problemas con GPU AMD

Compatibilidad con ROCm (solo Linux):

# Install stable ROCm PyTorch (7.2 at the time of writing)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2

# For nightly builds (ROCm 7.2 at the time of writing, which might have performance improvements)
pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.2

GPUs AMD no compatibles:

# For RDNA2 or older (6700, 6600)
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py

# For RDNA3 cards (7600)
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py

Optimización de rendimiento:

# Enable experimental memory efficient attention (no longer necessary with PyTorch 2.4)
TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1 python main.py --use-pytorch-cross-attention

# Enable tunable operations (slow first run, but faster subsequent runs)
PYTORCH_TUNABLEOP_ENABLED=1 python main.py

Problemas con Apple Silicon (M1/M2/M3)

Los pasos de esta sección se aplican a una instalación manual o desde el código fuente, en la que ComfyUI se ejecuta en un entorno de Python que configuras tú mismo. Consulta los Requisitos del sistema para ver las versiones de Python compatibles y la Instalación manual para los pasos de configuración.Comfy Desktop en Apple silicon no necesita una instalación de Python aparte: la app gestiona su propio entorno de Python para cada instancia. Consulta Comfy Desktop para macOS.

Configuración del backend MPS:

# Install PyTorch nightly for Apple Silicon
# Follow Apple's guide: https://developer.apple.com/metal/pytorch/

# Check MPS availability
python -c "import torch; print(torch.backends.mps.is_available())"

# Launch ComfyUI
python main.py

Si MPS causa problemas:

# Force CPU mode
python main.py --cpu

# With memory optimization
python main.py --force-fp16 --cpu

Problemas con GPU Intel

Error “Torch not compiled with CUDA enabled”: En las GPUs Intel este error significa que ComfyUI intentó usar CUDA porque el backend XPU no estaba disponible. No sigas los pasos de reinstalación de CUDA para NVIDIA indicados arriba. Las GPUs Intel usan XPU, no CUDA. Comprueba si PyTorch puede ver la GPU Intel:

python -c "import torch; print('XPU available:', hasattr(torch, 'xpu') and torch.xpu.is_available())"

Si imprime True, ComfyUI usa el backend XPU automáticamente. Si imprime False:

Confirma que tienes una GPU Intel Arc compatible (Arc serie A, Arc serie B o un procesador Core Ultra con Arc Graphics).
Instala o actualiza el controlador de GPU Intel.
Instala una versión de PyTorch con soporte XPU usando una de las opciones de abajo. No instales un wheel de CUDA.

Opción 1: soporte XPU nativo de PyTorch (Windows/Linux):

# Stable XPU wheels (recommended)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

# Nightly XPU wheels (may include performance improvements)
pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu

# Launch ComfyUI
python main.py

Opción 2: Intel Extension for PyTorch (IPEX):

# For Intel Arc A-Series Graphics
conda install libuv
pip install torch==2.3.1.post0+cxx11.abi torchvision==0.18.1.post0+cxx11.abi torchaudio==2.3.1.post0+cxx11.abi intel-extension-for-pytorch==2.3.110.post0+xpu --extra-index-url https://pytorch-extension.intel.com/release-whl/stable/xpu/us/

Preguntas frecuentes

¿Cómo ejecuto ComfyUI con Docker?

Docker: ComfyUI no proporciona una imagen oficial de Docker. Si quieres ejecutar ComfyUI en un contenedor, puedes usar las imágenes mantenidas por la comunidad en Docker Hub. Estas imágenes no están mantenidas oficialmente por Comfy-Org y no cuentan con el soporte del equipo de ComfyUI. Úsalas bajo tu propio riesgo.

Para la instalación local en Linux, sigue la Guía de instalación manual. Para el uso en la nube, consulta Comfy Cloud.

Obtener ayuda y reportar errores

Antes de reportar un error

Verifica si es un problema conocido:
- Busca en Problemas de GitHub
- Revisa el Foro de ComfyUI
- Consulta las discusiones de Discord
Prueba la solución de problemas básica:
- Prueba con el flujo de trabajo predeterminado
- Desactiva todos los nodos personalizados (consulta solución de problemas de nodos personalizados)
- Revisa la consola/terminal en busca de mensajes de error
- Si usas comfy-cli, intenta actualizar: comfy node update all

Cómo reportar errores de forma efectiva

Para problemas del núcleo de ComfyUI

Dónde reportar: Problemas de GitHub

Para problemas de la aplicación de escritorio

Dónde reportar: Problemas de GitHub de Desktop

Para problemas del frontend

Dónde reportar: Problemas de GitHub del frontend

Para problemas de nodos personalizados

Dónde reportar: Contacta al desarrollador específico del nodo personalizado

Información requerida

Al reportar cualquier problema, incluye:

Información del sistema

Desde la interfaz de ComfyUI
Desde la línea de comandos

Información del sistema (la puedes encontrar en la página Acerca de, en configuraciones):

Sistema operativo (Windows 11, macOS 14.1, Ubuntu 22.04, etc.)
Versión de ComfyUI (revisa la página Acerca de en configuraciones)
Versión de Python: python --version
Versión de PyTorch: python -c "import torch; print(torch.__version__)"
Modelo de GPU y versión del controlador
Método de instalación (Desktop, Portable, Manual, comfy-cli)

Windows
macOS/Linux

# Información del sistema
systeminfo | findstr /C:"OS Name" /C:"OS Version"

# Información de la GPU
wmic path win32_VideoController get name

# Información de Python y PyTorch
python --version
python -c "import torch; print(f'PyTorch: {torch.__version__}')"
python -c "import torch; print(f'CUDA Available: {torch.cuda.is_available()}')"

# Información del sistema
uname -a

# Información de la GPU (Linux)
lspci | grep VGA

# Información de Python y PyTorch
python --version
python -c "import torch; print(f'PyTorch: {torch.__version__}')"
python -c "import torch; print(f'CUDA Available: {torch.cuda.is_available()}')"

Problemas de la aplicación de escritorio

Para problemas de la aplicación de escritorio, incluye también:

Archivos de registro de: C:\Users\<username>\AppData\Roaming\ComfyUI\logs (Windows)
Archivos de configuración de: C:\Users\<username>\AppData\Roaming\ComfyUI (Windows)

Detalles del problema

Detalles del problema:

Descripción clara del problema
Pasos para reproducir el problema
Comportamiento esperado vs. real
Capturas de pantalla o videos si corresponde

Mensajes de error:

Texto completo del error de la consola/terminal
Errores de la consola del navegador (F12 → pestaña Consola)
Cualquier registro de fallos o diálogo de error

Contexto adicional

Contexto adicional:

Lista de nodos personalizados instalados
Archivo de flujo de trabajo (.json) que reproduce el problema
Cambios recientes (nuevas instalaciones, actualizaciones, etc.)

Recursos de la comunidad

Foro oficial: forum.comfy.org
Discord: Servidor de Discord de ComfyUI
Reddit: r/comfyui
YouTube: Tutoriales de ComfyUI

Gestión de cuenta

Soporte de facturación

Troubleshooting

Community

Cómo solucionar problemas de ComfyUI

Guía de solución de problemas de nodos personalizados

Problemas comunes y soluciones rápidas

ComfyUI no se inicia

La generación falla o produce errores

Rendimiento lento

Problemas específicos de la instalación

Problemas de la aplicación de escritorio

Problemas de la instalación manual

Problemas específicos de Linux

Problemas relacionados con los modelos

Problemas de red y API

Nodos asociados que no funcionan

Problemas de conexión

Problemas del frontend

Problemas específicos del hardware

Problemas con GPU NVIDIA

Problemas con GPU AMD

Problemas con Apple Silicon (M1/M2/M3)

Problemas con GPU Intel

Preguntas frecuentes

¿Cómo ejecuto ComfyUI con Docker?

Obtener ayuda y reportar errores

Antes de reportar un error

Cómo reportar errores de forma efectiva

Para problemas del núcleo de ComfyUI

Para problemas de la aplicación de escritorio

Para problemas del frontend

Para problemas de nodos personalizados

Información requerida

Recursos de la comunidad

Guía de solución de problemas de nodos personalizados

​Problemas comunes y soluciones rápidas

​ComfyUI no se inicia

​La generación falla o produce errores

​Rendimiento lento

​Problemas específicos de la instalación

​Problemas de la aplicación de escritorio

​Problemas de la instalación manual

​Problemas específicos de Linux

​Problemas relacionados con los modelos

​Problemas de red y API

​Nodos asociados que no funcionan

​Problemas de conexión

​Problemas del frontend

​Problemas específicos del hardware

​Problemas con GPU NVIDIA

​Problemas con GPU AMD

​Problemas con Apple Silicon (M1/M2/M3)

​Problemas con GPU Intel

​Preguntas frecuentes

​¿Cómo ejecuto ComfyUI con Docker?

​Obtener ayuda y reportar errores

​Antes de reportar un error

​Cómo reportar errores de forma efectiva

​Para problemas del núcleo de ComfyUI

​Para problemas de la aplicación de escritorio

​Para problemas del frontend

​Para problemas de nodos personalizados

​Información requerida

​Recursos de la comunidad

Problemas comunes y soluciones rápidas

ComfyUI no se inicia

La generación falla o produce errores

Rendimiento lento

Problemas específicos de la instalación

Problemas de la aplicación de escritorio

Problemas de la instalación manual

Problemas específicos de Linux

Problemas relacionados con los modelos

Problemas de red y API

Nodos asociados que no funcionan

Problemas de conexión

Problemas del frontend

Problemas específicos del hardware

Problemas con GPU NVIDIA

Problemas con GPU AMD

Problemas con Apple Silicon (M1/M2/M3)

Problemas con GPU Intel

Preguntas frecuentes

¿Cómo ejecuto ComfyUI con Docker?

Obtener ayuda y reportar errores

Antes de reportar un error

Cómo reportar errores de forma efectiva

Para problemas del núcleo de ComfyUI

Para problemas de la aplicación de escritorio

Para problemas del frontend

Para problemas de nodos personalizados

Información requerida

Recursos de la comunidad