El error “missing nodes” es uno de los más comunes al abrir un workflow en ComfyUI. Indica que el sistema ha detectado nodos personalizados (custom nodes) que no están instalados en tu ordenador. Puede parecer intimidante. No lo es.
Este error ocurre porque ComfyUI, por defecto, solo incluye nodos básicos. Los workflows compartidos por la comunidad usan 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.
Captura real del error
El diálogo real de “nodos faltantes” que muestra ComfyUI, con los nodos resaltados en rojo en el lienzo
¿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. Los nodos que faltan hacen que el workflow no se ejecute. Punto.
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 directo 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-Manager
Reinicia 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.
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. Más laborioso. 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.git
Sustituye 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.txt
Comprueba que pip corresponde al entorno de Python donde tienes instalado ComfyUI. Si usas un entorno virtual o Conda, actívalo antes de ejecutar el comando — de lo contrario las dependencias se instalan en el Python del sistema y ComfyUI no las encuentra. Si necesitas configurar tu entorno correctamente, la guía de instalación en Windows 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, especialmente cuando el workflow tiene cinco o más nodos personalizados encadenados.
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.txt
Si el workflow viene de Civitai o de un post de Reddit, el autor suele listar los nodos necesarios en la descripción. Empieza por ahí 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, comprueba que lo tenías activado antes del pip install. El error más habitual aquí es instalar dependencias en el Python del sistema en vez del entorno de ComfyUI — todo parece correcto pero el nodo sigue sin aparecer.
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 de instalación en Windows te da una base estable antes de empezar a añadir nodos.
Siguientes pasos en ComfyUI
Primeros pasos
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.