> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo solucionar problemas de ComfyUI

> Guía de solución de problemas de ComfyUI: descarta primero los nodos personalizados, corrige problemas comunes del núcleo y reporta errores con los detalles correctos.

> [!TIP]
>
> 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](https://docs.comfy.org/es/troubleshooting/custom-node-issues.md) 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](https://docs.comfy.org/es/troubleshooting/custom-node-issues.md)**
>
> 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:**

1. **Verifica los requisitos del sistema** - Asegúrate de que tu sistema cumpla los [requisitos mínimos](https://docs.comfy.org/es/installation/system_requirements.md)
2. **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:**

1. **Haz clic en "Show report"** - Lee el mensaje de error detallado para identificar el problema concreto
2. **Comprueba si es un problema de nodos personalizados** - [Sigue nuestra guía de solución de problemas de nodos personalizados](https://docs.comfy.org/es/troubleshooting/custom-node-issues.md)
3. **Verifica los archivos de modelo** - Consulta la [documentación de modelos](https://docs.comfy.org/es/basic-concepts/models.md) para configurar los modelos
4. **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:**

1. **Reduce la resolución o el tamaño del lote** - Disminuye el tamaño de la imagen o el número de imágenes
2. **Usa las opciones de optimización de memoria** - Consulta la sección de optimización de rendimiento de más abajo
3. **Cierra las aplicaciones innecesarias** - Libera RAM y VRAM
4. **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:

```bash theme={null}
# 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:

```bash theme={null}
# 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:

```bash theme={null}
# 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](https://docs.comfy.org/es/installation/desktop/windows.md).

**Windows**

* **Dispositivo no compatible**: Comfy Desktop para Windows solo admite GPUs NVIDIA con CUDA. Usa [ComfyUI Portable](https://docs.comfy.org/es/installation/comfyui_portable_windows.md) o la [instalación manual](https://docs.comfy.org/es/installation/manual_install.md) 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](https://docs.comfy.org/es/installation/desktop/usage/settings.md#avanzado) si las descargas fallan
* **Modelos faltantes**: los modelos no se copian durante la migración, solo se enlazan. Verifica las rutas de los modelos

**macOS**

* **"La app está dañada"**: permite la app en la configuración de Seguridad y privacidad
* **Problemas de rendimiento**: concede Acceso completo al disco en la configuración de Privacidad
* **Cierres inesperados**: revisa la app Consola para ver los informes de fallos

**Linux**

* **Bibliotecas faltantes**: instala las dependencias con el gestor de paquetes
* **Errores de LD\_LIBRARY\_PATH**: problemas con la ruta de las bibliotecas de PyTorch (ver más abajo)

### Problemas de la instalación manual

> [!NOTE]
>
> 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](https://pytorch.org/get-started/locally/) o el [sitio web de ROCm](https://rocm.docs.amd.com/projects/install-on-linux/en/develop/install/3rd-party/pytorch-install.html#using-a-wheels-package).

**Conflictos de versión de Python:**

```bash theme={null}
# 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:**

```bash theme={null}
# 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:**

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

```bash theme={null}
# 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
```

2. **Averigua qué bibliotecas tienes:**

```bash theme={null}
# 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'))")
```

3. **Configúralo de forma permanente para tu entorno:**

```bash theme={null}
# 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
```

4. **Alternativa: usa ldconfig:**

```bash theme={null}
# 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
```

5. **Depura la carga de bibliotecas:**

```bash theme={null}
# 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](https://docs.comfy.org/es/troubleshooting/model-issues.md).

## 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:**

1. **Verifica la validez de la clave API** - Comprueba las claves en [configuraciones de usuario](https://docs.comfy.org/es/interface/user.md)
2. **Revisa los créditos de la cuenta** - Asegúrate de tener suficientes [créditos de API](https://docs.comfy.org/es/interface/credits.md)
3. **Verifica la conexión a internet** - Prueba con otros servicios en línea
4. **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:**

1. **Revisa la configuración del firewall** - Permite que ComfyUI pase a través del firewall
2. **Prueba con otro puerto** - El predeterminado es 8188, prueba con 8189 o 8190
3. **Desactiva la VPN temporalmente** - La VPN puede estar bloqueando las conexiones
4. **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":**

```bash theme={null}
# 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](https://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":**

```bash theme={null}
# 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:**

```bash theme={null}
# 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.

```bash theme={null}
# 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
```

> [!NOTE]
>
> 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](https://github.com/Comfy-Org/docs/pull/1491).*

### Problemas con GPU AMD

**Compatibilidad con ROCm (solo Linux):**

```bash theme={null}
# 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:**

```bash theme={null}
# 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:**

```bash theme={null}
# 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)

> [!NOTE]
>
> 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](https://docs.comfy.org/es/installation/system_requirements.md) para ver las versiones de Python compatibles y la [Instalación manual](https://docs.comfy.org/es/installation/manual_install.md) 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](https://docs.comfy.org/es/installation/desktop/macos.md).

**Configuración del backend MPS:**

```bash theme={null}
# 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:**

```bash theme={null}
# 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:

```bash theme={null}
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`:

1. Confirma que tienes una GPU Intel Arc compatible (Arc serie A, Arc serie B o un procesador Core Ultra con Arc Graphics).
2. Instala o actualiza el [controlador de GPU Intel](https://www.intel.com/content/www/us/en/developer/articles/tool/pytorch-prerequisites-for-intel-gpu.html).
3. 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):**

```bash theme={null}
# 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):**

```bash theme={null}
# 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?

> [!NOTE]
>
> **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](https://hub.docker.com/search?q=comfyui). 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](https://docs.comfy.org/es/installation/manual_install.md). Para el uso en la nube, consulta [Comfy Cloud](https://docs.comfy.org/es/get_started/cloud.md).

## Obtener ayuda y reportar errores

### Antes de reportar un error

1. **Verifica si es un problema conocido:**
   * Busca en [Problemas de GitHub](https://github.com/Comfy-Org/ComfyUI/issues)
   * Revisa el [Foro de ComfyUI](https://forum.comfy.org/)
   * Consulta las [discusiones de Discord](https://discord.com/invite/comfyorg)

2. **Prueba la solución de problemas básica:**
   * Prueba con el [flujo de trabajo predeterminado](https://docs.comfy.org/es/get_started/first_generation.md)
   * Desactiva todos los nodos personalizados (consulta [solución de problemas de nodos personalizados](https://docs.comfy.org/es/troubleshooting/custom-node-issues.md))
   * 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](https://github.com/Comfy-Org/ComfyUI/issues)

#### Para problemas de la aplicación de escritorio

**Dónde reportar:** [Problemas de GitHub de Desktop](https://github.com/Comfy-Org/Comfy-Desktop/issues)

#### Para problemas del frontend

**Dónde reportar:** [Problemas de GitHub del frontend](https://github.com/Comfy-Org/ComfyUI_frontend/issues)

#### Para problemas de nodos personalizados

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

### Información requerida

Al reportar cualquier problema, incluye:

**1. Información del sistema**

**Desde la interfaz de ComfyUI**

**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)

  ![Página Acerca de en configuraciones](https://mintcdn.com/dripart/NmGUk_QSXQXRVtZP/images/troubleshooting/menu-about.jpg?fit=max\&auto=format\&n=NmGUk_QSXQXRVtZP\&q=85\&s=c5bbb54ba0d54a908d76ea3e863680d8)

**Desde la línea de comandos**

**Windows**

```bash theme={null}
# 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()}')"
```

**macOS/Linux**

```bash theme={null}
# 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()}')"
```

**2. 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)

**3. 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

**4. 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](https://forum.comfy.org/)
* **Discord:** [Servidor de Discord de ComfyUI](https://discord.com/invite/comfyorg)
* **Reddit:** [r/comfyui](https://reddit.com/r/comfyui)
* **YouTube:** [Tutoriales de ComfyUI](https://www.youtube.com/@comfyorg)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.