Qué hacer si no se instala: solución de problemas de instalación e inicio
El momento más frustrante al instalar ComfyUI no es la descarga lenta, sino después de instalar: haces doble clic en .bat y la ventana negra se cierra en un instante, o el servicio arranca pero el navegador se queda en blanco. Si ComfyUI no abre, lo más probable es que el problema esté en uno de tres puntos: un entorno de tarjeta gráfica incorrecto, el servicio que no arrancó de verdad, o un problema en el navegador. Esta lección cubre los errores comunes de la fase de instalación e inicio uno por uno, con su «texto original», causa y solución: primero usa la verificación rápida de 60 segundos para localizar la etapa, y luego encuentra tu caso.
Todas las soluciones y comandos provienen de la documentación oficial de solución de problemas, los scripts del paquete portátil oficial y el repositorio oficial; los textos de los errores provienen de la documentación oficial o de los títulos de issues públicos del repositorio oficial de ComfyUI. Los errores de la fase de generación de imágenes (nodos rojos, memoria de vídeo insuficiente) no están en el alcance de esta lección; consulta la vista general de solución de problemas.
Qué podrás hacer al terminar
- Determinar con 4 comandos en 60 segundos cuál falla: la tarjeta gráfica, PyTorch o Python
- Identificar cada caso de fallo de inicio de ComfyUI: ventana negra que se cierra al instante, errores de CUDA, librerías faltantes en Linux, con sus causas y soluciones
- Resolver los tres tipos de problemas de interfaz cuando ComfyUI no abre:
127.0.0.1:8188inaccesible, pantalla blanca o con artefactos, pantalla negra con cierre inesperado - Gestionar la versión de escritorio que no arranca: bloqueo de seguridad, bucle de actualización, tarjeta gráfica no compatible, y encontrar el archivo de registro oficial
app.log - Aprender la forma oficial de preguntar: reúne los seis datos del sistema y el texto completo del error antes de ir a GitHub Issues
Tu situación actual
- Haces doble clic en
.bat, la ventana negra se cierra en un instante sin que llegues a ver el error: el fallo de inicio de ComfyUI no deja ninguna pista - La ventana negra desplaza claramente un montón de registros, pero el navegador no abre
127.0.0.1:8188, o la interfaz aparece toda negra o toda blanca - El error es una cadena en inglés (¿
Torch not compiled with CUDA enabled?), la copias para buscar y las respuestas son variadas y contradictorias
Cuándo usar esta técnica
Cuando necesitas:
- Reparar la instalación: Windows paquete portátil o instalación alternativa con problemas de instalación o inicio atascados
- Localizar por tu cuenta antes de pedir ayuda en un foro: si los archivos no se instalaron bien, el entorno está mal, el servicio no arrancó, o la culpa es del navegador
Y no quieres:
- Ir al foro a esperar respuestas en cuanto hay un error: la verificación rápida de 60 segundos ahorra la mayoría de los ida y vuelta
- Confundir «el navegador necesita actualizarse» con «ComfyUI se instaló mal» y reinstalar en vano
🎒 Preparativos antes de empezar
- Haber pasado por la instalación: Windows paquete portátil o instalación alternativa (no pasa nada si te atascaste, esta lección es justamente para desatascarte)
- Poder encontrar la ventana negra de línea de comandos que inicia ComfyUI (paquete portátil / instalación manual) o la aplicación Comfy Desktop (versión de escritorio)
- Usuarios de la versión de escritorio: saber que el ☰ menú de la esquina superior izquierda puede abrir Desktop Settings
- Un vaso de agua ☕
💡 Usuarios de la versión de escritorio, mira aquí
Comfy Desktop gestiona el entorno de Python y las dependencias por ti; la solución de problemas de Python / pip de esta página va dirigida principalmente a usuarios del paquete portátil y de la instalación manual. Si la versión de escritorio no arranca, mira primero el grupo 4; para los registros, salta directamente a «¿Sigue sin funcionar?»: ahí está la ubicación del app.log oficial.
Idea central
ComfyUI tiene una estructura de dos capas: «servicio local + interfaz web». La ventana negra de línea de comandos (o la instancia que lanza la versión de escritorio) es el servicio en sí, y el navegador accede a http://127.0.0.1:8188 solo para ver su página web. Por eso «ComfyUI no abre» se divide en dos preguntas: ¿arrancó el servicio? ¿puede conectarse el navegador? — primero diagnostica por capas, luego mira el error.
| Tu síntoma | En qué capa está atascado | A qué grupo ir |
|---|---|---|
| 7z La descompresión falla o la descarga no avanza | Los archivos ni siquiera están en su lugar | Grupo 5 |
| La ventana negra se cierra en un instante / sale con un error | El servicio no arranca (driver, PyTorch) | Grupos 1 y 3 |
La ventana está, pero nunca aparece la línea To see the GUI | El arranque del servicio se interrumpe | Grupo 1 |
La línea To see the GUI aparece, pero el navegador no abre | Entre el servicio y el navegador | Grupo 2 |
| La interfaz se ve en blanco, con artefactos o en negro | Frontend / navegador | Grupo 2 |
| La versión de escritorio no abre o se cierra sola tras actualizar | La propia aplicación de escritorio | Grupo 4 |
Los dos primeros pasos "infalibles" que dan las fuentes oficiales. Las dos correcciones rápidas que la documentación oficial de resolución de problemas lista para "ComfyUI no arranca" son: verificar los requisitos mínimos del sistema y actualizar el driver de GPU a la última versión. El README del paquete portátil oficial también tiene una frase directa: si no arranca, actualiza tu driver de NVIDIA. Haz estas dos cosas primero y eliminarás la gran mayoría de los errores de instalación.
El texto original del error es la mejor palabra de búsqueda. Las últimas líneas de la ventana negra, el último fragmento de app.log, son el texto original que necesitas: úsalo para comparar con los títulos H4 de abajo, o cópialo directamente para buscar en GitHub Issues.
Primera revisión: verificación rápida en 60 segundos
Ejecuta los cuatro comandos en orden (en la terminal / línea de comandos). Usuarios del paquete portátil, atención: el Python incluido no está en el PATH del sistema; reemplaza python en los comandos por .\python_embeded\python.exe (primero haz cd para entrar en la carpeta ComfyUI_windows_portable); en los comentarios hay un ejemplo.
# 1. NVIDIA 显卡被识别吗?——应该看到显卡型号和驱动版本(AMD / Intel / Apple Silicon 用户跳过)
nvidia-smi
# 2. PyTorch 认得你的 GPU 吗?——应该看到 True
python -c "import torch; print(torch.cuda.is_available())"
# Windows 便携包用户改用下面这条
# .\python_embeded\python.exe -c "import torch; print(torch.cuda.is_available())"
# 3. 版本号(报 bug 时官方要这两项)
python -c "import torch; print(torch.__version__)"
python --version
# 便携包用户同上替换 python;官方便携包当前自带 Python 3.13 与 CUDA 13.0 版 PyTorchDeberías ver: el comando 1 imprime una tabla con la información de la tarjeta gráfica; el comando 2 imprime True; el comando 3 imprime los números de versión de PyTorch y de Python.
Repara por donde se rompa: si el comando 1 da error o no se encuentra → problema de driver (grupo 3); si el comando 2 imprime False → entorno de PyTorch (grupo 3); si ambos funcionan pero el servicio no arranca → grupo 1; si el servicio funciona pero la interfaz no abre → grupo 2.
Resolución de problemas frecuentes
Fallo de arranque: el programa no se inicia (fallo de arranque de ComfyUI)
Tras hacer doble clic en el .bat, la ventana negra se cierra en un instante, ComfyUI no arranca
Causa: el script de arranque no consiguió levantar ComfyUI; lo más común es un driver de tarjeta gráfica demasiado antiguo o la falta de bibliotecas de ejecución. El oficial escribió directamente un aviso en run_nvidia_gpu.bat, cuyo texto original es:
If you see this and ComfyUI did not start try updating your Nvidia Drivers to the latest.
If you get a c10.dll error you need to install vc redist that you can find: https://aka.ms/vc14/vc_redist.x64.exeSolución:
- Primero actualiza el driver de NVIDIA a la última versión (texto original del README del paquete portátil oficial: Update your Nvidia drivers if it doesn't start), y luego haz doble clic en
.bat - Si reporta el error
c10.dll: instala el runtime VC++ de Microsoft; la dirección que da el oficial es https://aka.ms/vc14/vc_redist.x64.exe; tras instalarlo, reintenta - Comprueba si descargaste el paquete correcto: la serie RTX 20 y superiores deben usar el paquete estándar; el paquete
cu126es solo para la serie GTX 10 y más antiguas (ver el grupo 5 «paquete de instalación descargado incorrectamente») - Si todavía no funciona: haz doble clic en
run_cpu.batpara probar una vez en modo CPU; el oficial indica que el modo CPU puede ejecutarse en cualquier hardware, pero esmuy lento (el oficial lo marca solo como último recurso; aquí se usa únicamente como verificación de diagnóstico). Si arranca, el problema queda acotado al entorno de GPU; ve al grupo 3
Deberías ver: tras actualizar el driver, vuelve a hacer doble clic en .bat; la ventana negra permanece estable y desplaza el registro, y al final aparece To see the GUI go to: http://127.0.0.1:8188.
"Torch not compiled with CUDA enabled"
Causa: PyTorch se instaló como versión CPU o en una versión incompatible con la tarjeta gráfica; ComfyUI quiere usar CUDA pero este torch no fue compilado con soporte CUDA. Es lo más común entre usuarios de instalación manual; la forma completa de este mismo error en la sección de issues del repositorio oficial es AssertionError: Torch not compiled with CUDA enabled.
Solución:
- Primero desinstala y luego reinstala según tu tarjeta gráfica (ítem de resolución de problemas del README oficial):
pip uninstall torch
# NVIDIA 稳定版(CUDA 13.0)
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130- Verifica (comando 2 de la verificación rápida): solo se considera arreglado si
python -c "import torch; print(torch.cuda.is_available())"imprimeTrue - Atención usuarios de tarjetas Intel: este error en Intel es otra cosa: el backend XPU no está disponible y ComfyUI lo trata erróneamente como una tarjeta CUDA. No apliques tal cual los pasos de reinstalación CUDA de arriba; primero ejecuta el comando de verificación oficial:
python -c "import torch; print('XPU available:', hasattr(torch, 'xpu') and torch.xpu.is_available())"Si imprime False, instala la construcción XPU de PyTorch (comando original oficial); el oficial recuerda explícitamente que en Intel no se debe instalar el wheel de la versión CUDA:
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu- Usuarios del paquete portátil: el paquete incluye un PyTorch ya emparejado, así que normalmente no encontrarás este error; si aparece, significa que el entorno fue modificado; puedes considerar
update\update_comfyui_and_python_dependencies.bat(el oficial lo marca para usarse solo cuando hay problemas con las dependencias; haz una copia de seguridad de todo el directorio de instalación antes de ejecutarlo)
"cuDNN Frontend error: No valid execution plans built"
Causa: en tarjetas de arquitectura Blackwell (serie RTX 50), la atención SDPA por defecto de PyTorch puede seleccionar el backend cuDNN, y esta arquitectura no tiene planes de ejecución válidos. Descripción oficial: al ejecutar FLUX, se alcanza en el primer bloque de atención del UNet y no se genera ni una sola imagen.
Solución:
- Activa la implementación de atención escrita a mano al arrancar, evitando SDPA y cuDNN (el oficial lo llama la corrección fiable):
python main.py --use-split-cross-attention- Al mismo tiempo confirma la construcción de PyTorch: el oficial indica que Blackwell requiere una construcción de CUDA 12.8 o superior; las construcciones
cu121no funcionan en absoluto en estas tarjetas; cambia a una construcción CUDA 12.8+ / cu130
💡 No des rodeos
El oficial lo dijo claramente: desactivar el backend cuDNN antes del arranque ajustando sitecustomize.py con torch.backends.cuda.enable_cudnn_sdp(False)no sirve; esa opción no se conserva cuando CUDA se inicializa. El parámetro de arranque sí es la corrección fiable.
"libcuda.so.1: cannot open shared object file"
Causa: en Linux, PyTorch instala las bibliotecas de NVIDIA en site-packages/nvidia/, y el sistema por defecto no busca allí. El oficial agrupa los tres errores idénticos libcuda.so.1, libnccl.so y libnvinfer.so.X como síntomas de la misma clase de LD_LIBRARY_PATH.
Solución:
- Añade la ruta de las bibliotecas a la variable de entorno (usuarios de entorno virtual: recuerda reemplazar
python3.12por tu versión):
export LD_LIBRARY_PATH=$VIRTUAL_ENV/lib/python3.12/site-packages/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH
# conda 环境改用 $CONDA_PREFIX/lib/python3.12/site-packages/nvidia/nvjitlink/lib- Si no quieres escribir la ruta a mano, deja que Python encuentre site-packages por sí mismo (comando original oficial):
PYTHON_PATH=$(python -c "import site; print(site.getsitepackages()[0])")
export LD_LIBRARY_PATH=$PYTHON_PATH/nvidia/nvjitlink/lib:$LD_LIBRARY_PATH
# 可能还需要其他 NVIDIA 库目录
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- Para una solución definitiva: añádelo al script
activatedel entorno virtual o a~/.bashrc(la documentación oficial ofrece dos formas de hacerlo) - Verificación:
python -c "import torch; print('CUDA available:', torch.cuda.is_available()); print('CUDA version:', torch.version.cuda)"
Deberías ver: el paso 4 imprime CUDA available: True y el número de versión de CUDA, y a continuación python main.py se inicia con normalidad.
ComfyUI no se abre: 127.0.0.1:8188, pantalla negra y pantalla blanca
"Failed to connect to server"
Causa: se ha roto la conexión entre el servicio y el navegador. La documentación oficial Connection Issues da cuatro comprobaciones: firewall, puertos, VPN y proxy; a las que se añade la quinta causa más común: el servicio directamente no llegó a iniciarse.
Solución:
- Primero mira si la ventana negra contiene esta línea:
To see the GUI go to: http://127.0.0.1:8188. Si no aparece, el servicio no se ha iniciado; vuelve al grupo 1 - Si la línea aparece pero el navegador no se abre automáticamente: esto no es un fallo—la documentación oficial indica que normalmente se abre solo; si no es así, abre tú mismo el navegador y accede a
http://127.0.0.1:8188 - Reintenta con otro puerto (el predeterminado es 8188; la recomendación oficial es probar con 8189 o 8190). Los usuarios del paquete portátil deben editar el
.batcon el Bloc de notas para añadir el parámetro (la documentación oficial ha mostrado cómo modificar un.batpara añadir parámetros de inicio):
.\python_embeded\python.exe -s ComfyUI\main.py --port 8189 --windows-standalone-build
pauseLos usuarios con instalación manual, directamente: python main.py --port 8189.
- Repasa la lista oficial: permite ComfyUI en el firewall, desactiva temporalmente la VPN y, si no necesitas proxy, desactívalo
- Atención para quienes hayan activado el acceso por LAN con
--listen: el registro mostraráTo see the GUI go to: http://0.0.0.0:8188, y los otros dispositivos deben usar la IP local de tu equipo (se consulta conWin + R→cmd→ipconfig);127.0.0.1significa «este equipo» y en el móvil no representa tu ordenador
Deberías ver: el navegador abre http://127.0.0.1:8188 (o el nuevo puerto) y aparece el lienzo de nodos.
La interfaz se ve blanca, con artefactos o con visualización anómala
Causa: el navegador es demasiado antiguo. Los requisitos del sistema oficiales indican explícitamente: Chrome 142 y versiones inferiores tienen problemas conocidos que provocan visualización anómala de la interfaz y problemas de rendimiento. En la sección de issues de GitHub también hay informes públicos relacionados con la pantalla blanca (por ejemplo, White screen wen loading Comfyui).
Solución:
- Actualiza Chrome a la versión 143 o superior antes de abrirlo (texto literal del requisito oficial)
- Si sigue en blanco tras cambiar de navegador: sigue «¿Sigue sin funcionar?» para recopilar los errores de la consola del navegador (F12 → Console), y luego busca en GitHub Issues
Deberías ver: tras la actualización, http://127.0.0.1:8188 renderiza con normalidad el lienzo de nodos.
Pantalla negra al iniciar o cierre directo (pantalla negra de ComfyUI)
Causa: la documentación oficial agrupa «cierre al iniciar, pantalla negra, fallo de carga» en un mismo síntoma llamado «ComfyUI Won't Start», y las correcciones rápidas que ofrece son solo dos: verificar los requisitos mínimos del sistema + actualizar el controlador de GPU.
Solución:
- Verifica los requisitos del sistema: consulta latabla de requisitos de tarjetas gráficas de la lección anterior y confirma que tu tarjeta está en la lista de soporte (NVIDIA / AMD / Intel Arc / Apple Silicon); si no hay tarjeta dedicada, hay que usar el modo CPU
- Actualiza el controlador de GPU (desde los sitios oficiales de NVIDIA / AMD / Intel; es la segunda corrección rápida oficial)
- Los usuarios del paquete portátil deben hacer doble clic en
run_cpu.bat(en instalación manual, iniciar con--cpu) y volver a probar: el modo CPU funciona en cualquier hardware, pero es muy lento—si arranca, el problema está en el entorno de GPU; continúa la comprobación en el grupo 3 - Usuarios de macOS: si hay problemas con MPS, la documentación oficial también ofrece la alternativa de CPU
python main.py --cpu(se puede usar--force-fp16 --cpucon optimización de memoria)
Deberías ver: tras actualizar el controlador (o cambiar al modo CPU), el servicio arranca por completo hasta To see the GUI go to: http://127.0.0.1:8188 y la interfaz ya no se queda en negro.
"Frontend or Templates Package Not Updated"
Causa: se actualizó el código de ComfyUI con git pull, pero las dependencias principales no se actualizaron en consonancia—el frontend, las plantillas de flujo de trabajo y la documentación de nodos son paquetes pip independientes. Cuando la actualización de dependencias falla, además se revierte a la versión antigua, y en el registro de inicio aparece Falling back to the default frontend..
Solución:
- Instala las dependencias que faltan en el entorno Python de ComfyUI (solución oficial):
pip install -r requirements.txt- En redes de China continental, añade el espejo de Tsinghua (proporcionado por la documentación oficial):
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple- Si sigue fallando: primero usa
pip listpara comparar versiones, y luego instala una a una según los números de versión indicados enComfyUI/requirements.txt(la advertencia oficial: no actualices por tu cuenta a la última versión):
pip install comfyui-frontend-package==<版本号>
pip install comfyui-workflow-templates==<版本号>- Permisos insuficientes: ejecuta la línea de comandos con permisos de administrador (uno de los pasos de diagnóstico oficiales)
Deberías ver: con las dependencias instaladas, el registro de inicio ya no muestra Falling back to the default frontend. y la interfaz está completa en funcionalidades.
Problemas de tarjeta gráfica y controladores
"CUDA error: no kernel image is available for execution on the device"
Causa: la construcción CUDA de PyTorch no incluye kernels compilados para la arquitectura de tu tarjeta—la construcción y la tarjeta no coinciden. Casos típicos: una tarjeta nueva con una construcción antigua (por ejemplo, Blackwell con cu121), o una tarjeta antigua con una construcción demasiado nueva.
Solución:
- Cambia al paquete / construcción correctos según la tabla oficial:
| Tarjeta gráfica | la que corresponde usar |
|---|---|
| Serie RTX 20 y superiores | Paquete / construcción estándar (CUDA 13.0) |
| Serie GTX 10 y más antiguas | paquete cu126 (CUDA 12.6, Python 3.12) |
| Serie RTX 50 (Blackwell) | Construcciones CUDA 12.8 y superiores (oficial: las construcciones cu121 no funcionan en absoluto) |
- Usuarios del paquete portátil: elimina el paquete descargado incorrectamente y vuelve a descargar y descomprimir según latabla de selección de paquetes de la lección anterior
- Usuarios con instalación manual: tras
pip uninstall torch, instala la versión correspondiente y verifica conpython -c "import torch; print(torch.cuda.is_available())"
"HIP error: invalid device function when running ComfyUI"
Causa: la arquitectura de la tarjeta AMD no está en la lista de soporte de la construcción ROCm utilizada. La documentación oficial ofrece una solución específica mediante variables de entorno para «tarjetas AMD no soportadas».
Solución (elige una según tu arquitectura, comandos oficiales literales):
# RDNA2 或更旧(如 6700、6600)
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py
# RDNA3(如 7600)
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.pyConfirma también que la fuente de PyTorch es la correcta—para AMD en Linux se usa la versión estable de ROCm:
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2"My GPU is not detected"
Causa: la versión de escritorio no detecta la GPU—controlador demasiado antiguo, falta la cadena de herramientas CUDA en Linux, o el tipo de instalación en sí no usa la GPU local (los tres casos listados en las FAQ oficiales).
Solución:
- Actualizar el controlador de NVIDIA
- Los usuarios de Linux confirman que tienen instalado el CUDA toolkit
- Confirmar que el tipo de instalación es compatible con GPU: Standalone y Git Clone son compatibles; la conexión Cloud usa una GPU remota
- Verificación por línea de comandos (versión ampliada de la comprobación rápida 1, comando oficial original):
nvidia-smi
nvidia-smi --query-gpu=driver_version --format=csvDeberías ver: nvidia-smi imprime el modelo de la tarjeta gráfica y la versión del controlador; la versión de escritorio detecta y usa la GPU con normalidad.
Problemas de la versión de escritorio de Comfy Desktop
"The app won't start after installation"
Causa: bloqueo del inicio relacionado con la plataforma: permisos, configuración de seguridad o bibliotecas faltantes. El FAQ oficial da cuatro casos por plataforma.
Solución:
- Windows: ejecutar una vez como administrador
- macOS: si aparece una advertencia de seguridad, ir a Ajustes del sistema → Privacidad y seguridad y hacer clic en Abrir de todos modos (Open Anyway)
- Linux: confirmar que FUSE 2 está instalado (
sudo apt install libfuse2); si en Ubuntu 24.04+ el AppArmor bloquea el sandbox de Electron, añadir--no-sandboxy reintentar — ⚠️ advertencia oficial: ese parámetro desactiva el sandbox de Electron en cada proceso, úsalo solo cuando el sandbox falle al iniciar - Ir a la página de descargas y confirmar que tienes la última versión
Deberías ver: tras tratar el problema según la plataforma, la ventana de Comfy Desktop se abre y entra al panel o a la configuración inicial.
"App is damaged"
Causa: el mecanismo de seguridad de macOS marca la aplicación como «dañada». Es el primer punto de la entrada oficial de resolución de problemas de macOS.
Solución: ir a Ajustes del sistema → Privacidad y seguridad y autorizar la aplicación. En la misma página, las entradas oficiales también indican: para problemas de rendimiento, conceder acceso completo al disco; para fallos, consultar los informes de fallos en la app «Consola».
"Comfy Desktop closes by itself after an update (Windows)"
Causa: bug confirmado oficialmente — en la versión de Windows 1.0.46 y anteriores, si la descarga de la actualización no se completa, la app muestra un instante la interfaz de actualización y se cierra sola, y se reproduce en cada inicio, sin dar tiempo a la autorreparación. Corregido a partir de 1.0.47.
Solución: instalar manualmente la última versión (pasos de recuperación oficiales):
- Descargar el instalador más reciente de Windows (o obtenerlo desde la página de descargas)
- Ejecutar la instalación directamente, no hace falta desinstalar antes la versión anterior
- Iniciar Comfy Desktop
Deberías ver: la app se abre con normalidad y ya no se cierra automáticamente — tu instancia instalada, tus modelos y tus ajustes siguen ahí (retención confirmada oficialmente).
"Unsupported device"
Causa: la versión de Windows de Comfy Desktop solo es compatible con tarjetas gráficas NVIDIA CUDA — palabras textuales de la documentación oficial de resolución de problemas. Quien tenga una tarjeta AMD / Intel e instale la versión de escritorio de Windows se topará con esto.
Solución: los usuarios de Windows con tarjetas AMD / Intel deben usar las otras dos rutas oficiales:
- Paquete portátil oficial: paquete AMD (
ComfyUI_windows_portable_amd.7z) o paquete Intel (ComfyUI_windows_portable_intel.7z), ver la tabla de selección de paquetes de la lección anterior - Instalación manual (instalando el PyTorch correspondiente a tu tarjeta gráfica)
Fallo de descarga, atasco en la página de Maintenance o aviso de falta de espacio en disco
Causa: la versión de escritorio debe descargar archivos desde GitHub / PyPI; una red o configuración de espejo incorrecta provoca atascos; además, al crear una instancia se comprueba obligatoriamente el espacio en disco.
Solución:
- Atasco en la página de Maintenance: la recomendación oficial es revisar la configuración de espejos — en la interfaz en chino puedes activar en los ajustes Use Chinese Mirrors (Git & PyPI): los repositorios Git pasan por
gitcode.comy PyPI por los espejos de Alibaba Cloud y Tencent; la documentación oficial indica que esto es más rápido en China continental - Low Disk Space es solo una advertencia: puedes elegir Continue Anyway para continuar (o cambiar la ruta de instalación); Not Enough Space for Template Models sí bloquea esa plantilla — cambia a un flujo de trabajo más ligero o libera espacio en disco
- Fallo del instalador: la recomendación oficial es ejecutarlo como administrador + asegurarse de tener al menos 15 GB de espacio en disco; para cada instalación independiente de la versión de escritorio, el requisito oficial es de al menos 4.85 GB
Problemas de descarga y descompresión (ComfyUI no se instala)
7z falla al descomprimir o faltan archivos tras la descompresión
Causa: Windows añade la marca de «bloqueado» a los archivos descargados de internet, lo que provoca problemas al descomprimir. El README oficial tiene una frase específica al respecto: If you have trouble extracting it, right click the file -> properties -> unblock.
Solución:
- Clic derecho en el archivo
.7z→ Propiedades → marcar «Desbloquear (Unblock)» → Aceptar, y descomprimir de nuevo - Si aún no funciona: descomprimir con 7-Zip (la documentación oficial también indica que el Explorador de Windows más reciente puede descomprimir directamente)
Deberías ver: la carpeta ComfyUI_windows_portable descomprimida por completo, con run_nvidia_gpu.bat, python_embeded y demás dentro.
Paquete de instalación equivocado: se descargó el paquete cu126 para una tarjeta nueva (o viceversa)
Causa: la documentación oficial ofrece varios paquetes según la tarjeta gráfica, y los únicos fáciles de confundir son los dos de NVIDIA. El paquete cu126 es solo para tarjetas de la serie GTX 10 y más antiguas; la documentación oficial lo enfatiza en mayúsculas: DO NOT USE THIS ON NEWER 20 SERIES AND ABOVE GPUS.
Solución: verificar el nombre del archivo y volver a descargarlo (la tabla completa de correspondencias está en la lección anterior):
| Tu tarjeta gráfica | Nombre de archivo correcto |
|---|---|
| Serie RTX 20 y superiores | ComfyUI_windows_portable_nvidia.7z |
| GTX 10 serie y anteriores | ComfyUI_windows_portable_nvidia_cu126.7z |
| AMD | ComfyUI_windows_portable_amd.7z |
| Intel | ComfyUI_windows_portable_intel.7z |
Deberías ver: tras descomprimir el nuevo paquete, haz doble clic en el .bat correspondiente y el inicio ya no da errores de arquitectura.
Descarga lenta o fallida (red de China continental)
Causa: el paquete de instalación está alojado en GitHub Releases; la documentación oficial menciona que los usuarios de China continental pueden necesitar configurar un proxy para acceder de forma estable al repositorio de GitHub. Una descarga lenta no significa que hayas hecho algo mal.
Solución:
- Configurar un proxy para acceder a GitHub (solución oficial)
- Usuarios de la versión de escritorio: activar el espejo chino (Git usa
gitcode.com, PyPI usa los espejos de Alibaba Cloud y Tencent, ver el punto anterior) - Al instalar dependencias manualmente, cambia pip al espejo de Tsinghua (oficial):
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple - Obtén el paquete solo de canales oficiales: GitHub Releases y comfy.org/download
¿Sigue sin funcionar?
Recopila evidencia antes de preguntar. La plantilla oficial de reporte de bugs pide seis datos del sistema; tenlos listos primero:
| Dato | Cómo obtenerlo |
|---|---|
| Sistema operativo | Windows: systeminfo | findstr /C:"OS Name" /C:"OS Version"; macOS/Linux: uname -a |
| Versión de ComfyUI | Interfaz Settings → About |
| Versión de Python | python --version |
| Versión de PyTorch | python -c "import torch; print(f'PyTorch: {torch.__version__}')" |
| Modelo de GPU y controlador | Windows: wmic path win32_VideoController get name; Linux: lspci | grep VGA; versión del controlador nvidia-smi --query-gpu=driver_version --format=csv |
| Método de instalación | Desktop / Portable / Manual / comfy-cli |
Añade tres cosas más: el texto completo del error de la consola, los errores de la consola del navegador (F12 → Console), y el flujo de trabajo que reproduce el problema .json junto con la lista de nodos personalizados.
Los usuarios de la versión de escritorio deben buscar primero los registros. Comfy Desktop escribe registros rotativos app.log; la vía más rápida es Desktop Settings → Logs → Diagnostics → Open logs folder (entra a ajustes desde el menú ☰). Ubicación predeterminada:
| Plataforma | Carpeta de registros |
|---|---|
| Windows | %APPDATA%\Comfy Desktop\logs |
| macOS | ~/Library/Logs/Comfy Desktop |
| Linux | ~/.config/Comfy Desktop/logs |
Mira app.log (las sesiones antiguas están en app.log_*.log con marca de tiempo). Para ver la salida del propio proceso ComfyUI, abre el panel Manage de la instancia y usa la pestaña Terminal.
Dónde preguntar (referencia de canales oficiales):
| Canal | Para qué tipo de problema |
|---|---|
| ComfyUI GitHub Issues | Problemas del núcleo de ComfyUI |
| Comfy-Desktop Issues | Problemas de la versión de escritorio |
| ComfyUI_frontend Issues | Problemas del frontend |
| Los autores de nodos personalizados | Problemas de custom nodes (oficial: acude al desarrollador del nodo concreto) |
| Foro oficial / Discord / r/comfyui | Ayuda de la comunidad |
💡 Tres cosas que la oficial recomienda antes de preguntar
Primero busca en GitHub Issues y en el foro para confirmar que no es un problema conocido; prueba una vez con el flujo de trabajo predeterminado para descartar factores del flujo; si instalaste con comfy-cli, ejecuta primero comfy node update all. Para errores de la fase de generación (nodos personalizados, carga de modelos, VRAM), entra desde el resumen de solución de problemas.
Punto de control ✅
- He ejecutado los cuatro comandos de la verificación rápida de 60 segundos y sé cuál falla
- Cuando la ventana negra se cierra en un instante, sé el orden: primero actualizar el controlador de la GPU → si reporta c10.dll, instalar el runtime de VC++ → verificar que el paquete descargado es el correcto
- Cuando
127.0.0.1:8188no se abre, primero confirmo si aparece la líneaTo see the GUIen la ventana negra, y luego reviso el firewall / VPN / cambio de puerto - Si la interfaz se ve en blanco o con artefactos, mi primera reacción es revisar la versión de Chrome (143 o superior)
- Al preguntar incluiré los seis datos del sistema + el texto completo del error +
app.log(versión de escritorio)
Resumen de la lección
✅ ComfyUI: si no se abre, analiza por capas: ¿están todos los archivos instalados (grupo 5)? → ¿arranca el servicio (grupos 1 y 3)? → ¿se conecta el navegador (grupo 2)? → ¿la versión de escritorio funciona bien (grupo 4)?
✅ Dos soluciones oficiales universales: verificar los requisitos del sistema + actualizar el controlador de la GPU; haz estas dos cosas antes de investigar en detalle.
✅ Cómo preguntar: seis datos del sistema + texto completo del error + registros, y acude al repositorio oficial de GitHub correspondiente o a la comunidad.
Repaso de las señales clave:
| Señal | En qué capa | Primer paso |
|---|---|---|
| La ventana negra se cierra en un instante | Arranque | Actualizar el controlador de la GPU; c10.dll → instalar el runtime de VC++ |
Torch not compiled with CUDA enabled | entorno PyTorch | desinstala torch y reinstálalo según tu tarjeta gráfica |
Aparece la línea To see the GUI pero no se abre | servicio ↔ navegador | accede manualmente; revisa el cortafuegos / VPN / cambia de puerto |
| pantalla en blanco o con artefactos | navegador | actualiza Chrome a la versión 143+ |
App is damaged | seguridad de macOS | permite la app en Privacidad y seguridad |
| la página Maintenance se queda bloqueada | red | revisa la configuración de espejos / activa un espejo chino |
Vista previa de la próxima lección
Con el entorno estabilizado, el siguiente paso es ir a Dónde colocar los modelos: guía detallada del directorio models y extra_model_paths.
Aprenderás:
- Estructura completa del directorio
modelsy qué se coloca en cada subdirectorio - cómo ubicar correctamente checkpoint, VAE y LoRA
- cómo usar
extra_model_paths.yamlpara compartir modelos entre varias instalaciones
Si quieres generar imágenes directamente, después de colocar los modelos ve a Tu primera generación de imágenes.