El error “missing nodes” es uno de los más comunes al abrir un workflow en ComfyUI. Este mensaje indica que el sistema ha detectado nodos personalizados (custom nodes) que no están instalados en tu ordenador. Aunque puede parecer intimidante, es uno de los problemas más sencillos de resolver.
Este error ocurre porque ComfyUI, por defecto, solo incluye una serie de nodos básicos. Los workflows compartidos por la comunidad suelen usar extensiones adicionales que no vienen instaladas automáticamente. Estas extensiones amplían las capacidades del programa con funciones como ControlNet, upscaling, procesado de vídeo o integraciones con modelos específicos. En esta guía verás tres métodos para solucionarlo, del más sencillo al más manual.
Si acabas de instalar ComfyUI y abres un workflow descargado de Internet, casi con certeza necesitarás instalar nodos adicionales. Es algo completamente normal, no un error de tu instalación. Esta guía aplica tanto a la versión web clásica de ComfyUI como a ComfyUI Desktop.
¿Qué significa exactamente el error Missing Nodes?
Para entender qué está pasando, hay que conocer qué son los custom nodes en ComfyUI. Son extensiones que se añaden a la carpeta custom_nodes del proyecto y permiten realizar tareas específicas no incluidas en los nodos base.
Cuando cargas un workflow, ComfyUI busca todos los nodos que este requiere. Si alguno no está instalado, muestra el aviso de “missing nodes” y colorea en rojo los nodos afectados en el canvas. El workflow no puede ejecutarse hasta que todos estén disponibles.
El error no impide ejecutar ComfyUI en sí mismo. Solo bloquea la ejecución de workflows que dependen de nodos no instalados. Tu instalación base sigue funcionando correctamente.
La estructura de un workflow en ComfyUI es una red de nodos conectados. Cada nodo representa una operación: cargar imagen, aplicar ControlNet, hacer upscaling, muestrear con un modelo… Si uno de esos nodos no existe en tu sistema, la cadena se rompe. Los nodos esenciales de ComfyUI vienen de serie; todo lo demás hay que instalarlo.
Método 1: Instalar nodos que faltan con ComfyUI Manager (recomendado)
El método más sencillo es usar ComfyUI Manager, una extensión que permite instalar, actualizar y gestionar nodos personalizados de forma visual, sin tocar la terminal. Si aún no lo tienes, consulta la guía de ComfyUI Manager para instalarlo primero.
Instalar ComfyUI Manager si no lo tienes
Abre una terminal en el directorio raíz de tu instalación de ComfyUI y ejecuta:
git clone https://github.com/ltdrdata/ComfyUI-Manager.git custom_nodes/ComfyUI-ManagerReinicia ComfyUI para que reconozca el nuevo nodo. A partir de ahora verás el botón Manager en la interfaz.
Usar “Install Missing Custom Nodes”
Con el workflow problemático abierto:
- Haz clic en el botón Manager en la barra superior de ComfyUI.
- En el menú que aparece, selecciona “Install Missing Custom Nodes”.
- El sistema muestra una lista de todos los nodos que faltan en el workflow actual.
- Haz clic en “Install” junto a cada nodo, o usa “Install All” si quieres instalarlos todos de una vez.
- Cuando termine, haz clic en “Restart” para reiniciar el servidor.
Después de reiniciar, vuelve a cargar el workflow. Si todos los nodos se instalaron correctamente, el error desaparecerá y podrás ejecutar el workflow sin problemas.
Método 2: Instalación manual con Git Clone
Cuando ComfyUI Manager no detecta algún nodo o el repositorio no aparece en su lista, toca instalarlo a mano. Es más laborioso pero completamente fiable.
Paso 1: Localizar el repositorio del nodo
El mensaje de error de ComfyUI suele mostrar el nombre del nodo faltante, por ejemplo ComfyUI_IPAdapter_plus o comfyui-reactor-node. Busca ese nombre en GitHub para encontrar el repositorio oficial.
Paso 2: Clonar el repositorio en custom_nodes
cd /ruta/a/ComfyUI/custom_nodes
git clone https://github.com/autor/nombre-del-nodo.gitSustituye la URL por la del repositorio que has encontrado.
Paso 3: Instalar dependencias
La mayoría de nodos incluyen un archivo requirements.txt. Instálalo con:
cd nombre-del-nodo
pip install -r requirements.txtAsegúrate de que pip corresponde al entorno de Python donde tienes instalado ComfyUI. Si usas un entorno virtual o Conda, actívalo primero. Si necesitas configurar tu entorno correctamente, la guía completa de instalación explica cómo hacerlo.
Reinicia ComfyUI cuando termines.
Método 3: Usar el archivo de dependencias del workflow
Algunos workflows compartidos en GitHub incluyen un archivo README.md o requirements.txt con la lista exacta de nodos y dependencias necesarias. Es la forma más precisa de saber qué instalar.
Abre el README.md del workflow descargado y busca una sección de instalación. Suele tener una lista de nodos con sus repositorios de GitHub, o directamente un bloque de comandos. Sigue las instrucciones en el orden indicado, ya que algunos nodos dependen de otros.
Si el README incluye un requirements.txt, instálalo directamente:
pip install -r requirements.txtSi el workflow viene de Civitai o de un post de Reddit, el autor suele listar los nodos necesarios en la descripción. Es la primera fuente de información que deberías consultar antes de intentar cualquier otro método.
Nodos que faltan más comunes y dónde encontrarlos
Estos son los nodos personalizados que aparecen con más frecuencia en el error “missing nodes”:
| Nodo | Repositorio |
|---|---|
| Impact Pack | ltdrdata/ComfyUI-Impact-Pack |
| ControlNet Aux | Fannovel16/ComfyUI-ControlNet-Aux |
| WAS Node Suite | WASasquatch/was-node-suite-comfyui |
| VideoHelperSuite | Kosinkadink/ComfyUI-VideoHelperSuite |
| Advanced ControlNet | Kosinkadink/ComfyUI-Advanced-ControlNet |
| IPAdapter Plus | cubiq/ComfyUI_IPAdapter_plus |
| ComfyUI-AnimateDiff | Kosinkadink/ComfyUI-AnimateDiff-Evolved |
| ReActor | Gourieff/comfyui-reactor-node |
Si trabajas con workflows de ControlNet, casi siempre necesitarás ControlNet Aux y Advanced ControlNet. Si haces vídeo, VideoHelperSuite y AnimateDiff son imprescindibles. Los mejores nodos personalizados tiene un análisis más detallado de cada uno.
Qué hacer si el error persiste después de instalar los nodos
Si tras instalar los nodos el error sigue apareciendo, prueba estos pasos en orden:
Reiniciar completamente ComfyUI. Para con Ctrl + C en la terminal y arranca de nuevo con python main.py. Algunos nodos solo se reconocen tras un reinicio limpio.
Verificar que instalaste en el entorno correcto. Si usas Conda o un entorno virtual, asegúrate de haberlo activado antes del pip install. Un error habitual es instalar dependencias en el Python del sistema en vez del entorno de ComfyUI.
Revisar la consola de errores. La terminal donde corre ComfyUI muestra trazas de error detalladas. Busca líneas con ImportError o ModuleNotFoundError: indican exactamente qué librería falta.
Comprobar conflictos entre nodos. Algunos nodos modifican las mismas dependencias y pueden entrar en conflicto. Si tienes muchos nodos instalados, desactiva los que no usas moviéndolos fuera de la carpeta custom_nodes temporalmente.
No instales nodos de fuentes desconocidas. Descarga siempre desde el repositorio oficial de GitHub del autor. Los fundamentos de nodos en ComfyUI explica cómo evaluar si un nodo es fiable antes de instalarlo.
El error “missing nodes” deja de ser un obstáculo en cuanto tienes ComfyUI Manager instalado: en dos clics resuelves el 90% de los casos. Para el resto, el método manual con git clone es completamente suficiente. Si estás construyendo tu setup desde cero, la guía completa de instalación cubre todo lo que necesitas para tener un entorno estable desde el principio.
Preguntas frecuentes
- ¿Por qué aparece el error 'missing nodes' en ComfyUI?
- Aparece cuando abres un workflow que usa nodos personalizados (custom nodes) que no están instalados en tu sistema. ComfyUI solo incluye nodos base; los workflows de la comunidad dependen de extensiones adicionales que debes instalar manualmente.
- ¿Es obligatorio usar ComfyUI Manager para instalar nodos?
- No es obligatorio, pero es el método más cómodo. Puedes instalar nodos manualmente haciendo git clone en la carpeta custom_nodes y ejecutando pip install -r requirements.txt. ComfyUI Manager automatiza ese proceso con interfaz visual.
- ¿Puedo instalar missing nodes sin conexión a internet?
- Solo si tienes los archivos del nodo descargados. La instalación manual via git clone requiere conexión. Sin internet, copia la carpeta del nodo directamente en ComfyUI/custom_nodes/ desde otro equipo y ejecuta pip install localmente.
- ¿Los missing nodes afectan al rendimiento de GPU?
- No directamente. Los nodos que faltan simplemente hacen que el workflow no se cargue. Una vez instalados correctamente, el impacto en VRAM y velocidad depende de qué hace cada nodo, no de que estuvieran missing.