ComfyUI Manager: instalar nodos, reparar los erreurs

#Para qué sirve ComfyUI Manager

ComfyUI solo sabe hacer de forma nativa lo que permiten sus nodos integrados. Todo lo demás —ControlNet avanzado, preprocesadores, ampliadores, herramientas de vídeo y nodos de utilidad— procede de extensiones llamadas custom nodes. Cada custom node es un repositorio Git que contiene código Python, ubicado en la carpeta custom_nodes de tu instalación y cargado al iniciarse.

Sin Manager, instalar una extensión equivale a clonar un repositorio manualmente, instalar sus dependencias de Python en el entorno correcto y reiniciar. El Manager realiza estos pasos desde una ventana de la interfaz. Sobre todo, aporta tres funciones que siempre se terminan utilizando: detectar los nodes que faltan en un workflow, un botón de reparación para los nodes que se niegan a cargarse y snapshots para volver atrás después de una actualización desafortunada.

Custom Nodes Manager

El catálogo: búsqueda, instalación, actualización, desactivación y desinstalación de las extensiones registradas.

Install Missing Custom Nodes

Analiza el workflow abierto y enumera las extensiones ausentes que explican los nodos rojos.

Model Manager

Descarga modelos conocidos directamente en la subcarpeta correcta de models.

Update All

Actualiza todas las extensiones instaladas de una vez. Es práctico, pero también es el comando que rompe con más frecuencia una instalación que funcionaba.

Snapshot Manager

Guarda el estado de la instalación (versión de ComfyUI, extensiones y paquetes Python) para poder volver a él.

#Requisito previo: saber dónde está tu carpeta custom_nodes

El Manager, como cualquier extensión, se encuentra en la carpeta custom_nodes. Su ubicación depende de cómo hayas instalado ComfyUI, y la mitad de los problemas de «node instalado pero ausente» se deben a una extensión colocada en la carpeta equivocada o a dependencias instaladas en el Python incorrecto.

ComfyUI Desktop

La carpeta base es la que elegiste durante la instalación (a menudo, una carpeta ComfyUI en tus Documentos). Contiene custom_nodes, models, input y output. La aplicación gestiona el entorno de Python en una carpeta .venv situada junto a ella.

Versión portátil para Windows

En el archivo descomprimido: ComfyUI_windows_portable/ComfyUI/custom_nodes. El Python dedicado es ComfyUI_windows_portable/python_embeded, y es el que debes utilizar para instalar dependencias; nunca uses el Python del sistema.

Instalación manual (git clone)

ComfyUI/custom_nodes, con el entorno virtual que creaste para ComfyUI. Actívalo antes de ejecutar cualquier comando pip.

En todos los casos

Git debe estar instalado y ser accesible: Manager clona los repositorios con él. En Windows, compruébalo con git --version en un terminal.

Si ComfyUI aún no está instalado, empieza por la guía de instalación de ComfyUI, que compara Desktop, portable e instalación manual. Esta guía presupone una instalación que ya genera una imagen.

#Instalar ComfyUI Manager según tu versión

Hay tres situaciones, y la primera es la más frecuente en 2026: el Manager ya está ahí. Comprueba primero si hay un botón Manager en la barra superior de la interfaz antes de instalar nada.

#Caso 1: ya está incluido (Desktop, comfy-cli)

La aplicación ComfyUI Desktop incluye el Manager. Lo mismo ocurre con una instalación realizada con la herramienta de línea de comandos comfy-cli, que lo añade de forma predeterminada. Si el botón Manager aparece en la parte superior de la interfaz, no tienes que hacer nada: pasa a la sección siguiente.

#Caso 2: ComfyUI reciente, Manager integrado pero desactivado

El repositorio principal de ComfyUI ahora integra el Manager como dependencia opcional. No se activa por sí solo: hay que instalar el archivo manager_requirements.txt presente en la raíz de ComfyUI y después iniciar el servidor con la opción --enable-manager. Es la vía preferente para una instalación manual reciente, porque así el Manager sigue la versión esperada por su ComfyUI.

cd ComfyUI
pip install -r manager_requirements.txt
python main.py --enable-manager

Para no volver a escribir la opción cada vez, añádala a su script de inicio o a su servicio. En la versión portable, se coloca al final de la línea de comandos del archivo run_nvidia_gpu.bat (o de su equivalente de AMD o Intel).

#Caso 3: instalación clásica en custom_nodes

Este es el método histórico, que sigue documentado en el repositorio del Manager, y el único posible en una versión de ComfyUI que no tenga el archivo manager_requirements.txt. Se clona el repositorio en custom_nodes y después se reinicia ComfyUI por completo.

cd ComfyUI/custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
# puis arrêter ComfyUI (Ctrl+C) et le relancer
cd ..
python main.py

cd ComfyUI\custom_nodes
git clone https://github.com/Comfy-Org/ComfyUI-Manager.git
cd ..\..
.\python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt
# puis relancer run_nvidia_gpu.bat

Al reiniciar, lee el terminal. Una línea que mencione ComfyUI-Manager seguida de su número de versión confirma la carga. Si ves IMPORT FAILED junto a su nombre, las dependencias no se han instalado en el Python correcto: repite el comando pip con el entorno de ComfyUI.

#Añadir un custom node con el Manager

1. 01
   Abrir el catálogo

   Haz clic en Manager en la barra superior y, después, en Custom Nodes Manager. La primera vez que se abre, descarga la lista de extensiones registradas, lo que puede tardar unos segundos.
2. 02
   Buscar la extensión

   Escribe su nombre o una palabra clave en el campo de búsqueda. Las columnas indican el autor, la descripción, el número de estrellas de GitHub y, según las versiones, la fecha de la última actualización. Comprueba que el autor corresponde realmente al repositorio que te recomendaron: los nombres similares son frecuentes.
3. 03
   Instalar

   Haz clic en Install. Manager clona el repositorio en custom_nodes e instala las dependencias incluidas en su requirements.txt. El terminal muestra el progreso durante la operación. Si la extensión existe en Comfy Registry, Manager suele proponer una versión publicada y numerada en lugar de la última revisión de Git: elige la versión publicada, que es más estable.
4. 04
   Reiniciar

   Un banner te invita a reiniciar. Acéptalo. ComfyUI se reinicia, vuelve a cargar todas las extensiones y el navegador se reconecta. Actualiza la página si la interfaz no vuelve por sí sola.
5. 05
   Verificar

   Haz doble clic en el lienzo y escribe el nombre de un nodo de la extensión. Si aparece en la lista, ya está. Si no, lee la sección sobre los nodos instalados pero ausentes.

Para los scripts y las instalaciones sin interfaz, comfy-cli cubre la misma necesidad desde la línea de comandos: comfy node install seguido del nombre de la extensión la instala en la instalación activa de ComfyUI. El Manager y comfy-cli leen la misma carpeta custom_nodes, así que puedes combinar ambos.

#Nodos que faltan: el workflow se abre con nodos rojos

Este es el principal caso de uso de Manager. Cargas un workflow encontrado en internet o extraído de una imagen y ComfyUI muestra una ventana con una lista de tipos de nodos faltantes, junto con bloques rojos en el lienzo. El workflow utiliza extensiones que no tienes.

1. 01
   Leer la lista de tipos faltantes

   La ventana de advertencia muestra los nombres internos de los nodos. Anótalos: ayudan a encontrar la extensión si la detección automática falla.
2. 02
   Ejecutar Install Missing Custom Nodes

   En el menú Manager, este botón cruza los nodos faltantes con la base de extensiones conocidas y muestra cuáles los proporcionan. Márcalas e instálalas.
3. 03
   Reiniciar y volver a cargar el workflow

   Después de reiniciar, vuelva a abrir el archivo del workflow (o arrastre de nuevo la imagen). Los nodos rojos deben haber recuperado su color normal.
4. 04
   Tratar los restos manualmente

   Si un nodo sigue faltando, la detección no ha encontrado su extensión: no está registrada, ha cambiado de nombre o su autor ha cambiado el nombre del nodo. Busca el nombre interno del nodo en el repositorio o en el foro del que procede el workflow y, después, instala la extensión por su nombre en el catálogo.

Hay dos problemas que se repiten a menudo. El primero: un workflow que pide una extensión que no se encuentra en ningún otro sitio salvo mediante un enlace de descarga directa. Trátalo con desconfianza; es el patrón de los nodos maliciosos descritos más abajo. El segundo: un nodo faltante que en realidad pertenece al propio ComfyUI, porque tu versión es demasiado antigua. En ese caso, la solución es actualizar ComfyUI, no instalar nada.

#Node instalado pero ausente: IMPORT FAILED, desactivado, carpeta incorrecta

La extensión aparece como instalada en Manager, pero sus nodos no existen en la interfaz. El diagnóstico se realiza en el terminal al iniciar ComfyUI: allí se muestra cada extensión con su tiempo de carga, y las que fallan llevan la indicación IMPORT FAILED seguida de un traceback de Python. Este traceback es la única información útil; cópialo antes de pedir ayuda.

IMPORT FAILED con ModuleNotFoundError

Falta una dependencia de Python. En el Custom Nodes Manager, filtre por Import Failed y haga clic en Try fix: el Manager reinstala las dependencias de la extensión. Si falla, instale manualmente el requirements.txt de la extensión con el Python de ComfyUI (python_embeded en la portable).

IMPORT FAILED con un error de versión

La extensión exige una versión de un paquete (a menudo torch, numpy o transformers) incompatible con otra extensión o con ComfyUI. Hay que decidir: leer las issues del repositorio, desactivar la extensión menos útil o esperar una corrección. No fuerce una versión de torch, porque rompería ComfyUI.

Extensión desactivada

El Manager desactiva una extensión añadiendo el sufijo .disabled al nombre de su carpeta. ComfyUI la ignora por completo. Filtra por Disabled en el catálogo para volver a activarla o elimina el sufijo manualmente.

Carpeta equivocada

Tiene dos instalaciones (Desktop y portable, o dos clones), y la extensión está en el custom_nodes de la otra. La ruta exacta de la carpeta cargada aparece en las primeras líneas del terminal al iniciar.

Repositorio vacío o truncado

Un clon interrumpido deja una carpeta sin código. Elimina la carpeta de la extensión y vuelve a instalarla.

Cuando el propio ComfyUI ya no se inicia o la interfaz se vuelve inestable después de una instalación, la documentación oficial de solución de problemas recomienda aislar al culpable mediante una búsqueda dicotómica. Inicie primero ComfyUI sin ninguna extensión para confirmar que el problema procede realmente de un custom node.

python main.py --disable-all-custom-nodes

Si todo funciona así, mueve la mitad de las carpetas de custom_nodes a una carpeta aparte, reinicia y repite el proceso con la mitad restante hasta aislar la extensión defectuosa. Con diez extensiones, bastan cuatro reinicios. Después, desinstálala desde el Manager e informa del problema en su repositorio junto con el registro del terminal.

#Errores de registro: la lista de nodes no se carga

El Manager no almacena el catálogo localmente: al abrirse, descarga una lista de extensiones desde el repositorio del Manager y, para las extensiones publicadas, consulta el Comfy Registry, el repositorio oficial de Comfy Org donde los autores publican versiones numeradas. Cuando esta recuperación falla, el catálogo permanece vacío, la instalación de un node no termina nunca o aparece un mensaje que indica un fallo al cargar la lista.

Sin acceso de red desde el servidor

El Manager descarga desde la máquina que ejecuta ComfyUI, no desde tu navegador. En un servidor remoto o un contenedor, comprueba que tenga acceso a Internet (proxy, cortafuegos, DNS). Una prueba con curl a github.com desde esa máquina despeja la duda.

Modo de base de datos

En la ventana del Manager, un selector DB permite pasar del canal remoto a una copia local de la lista. El modo local permite seguir trabajando con las extensiones ya conocidas cuando GitHub no está disponible; no verá las extensiones añadidas desde entonces.

Canal

El Manager ofrece varios canales de listas (default, recent, legacy, dev, entre otros). Si una extensión no aparece, vuelva al canal default antes de buscar más; los demás canales sirven para extensiones antiguas o experimentales.

Límites de la API de GitHub

Después de numerosas solicitudes, GitHub puede rechazar temporalmente las llamadas anónimas. Espera unos minutos en lugar de volver a intentarlo repetidamente.

Acción rechazada por el nivel de seguridad

Si el Manager responde que una acción no está permitida con el nivel de seguridad actual, no es un error de red: lee la sección siguiente.

Último recurso, todavía válido: la instalación manual mediante git clone en custom_nodes, seguida del requirements.txt y de un reinicio. Después, el Manager reconoce la extensión como instalada y podrá actualizarla.

#Detectar una extensión de riesgo antes de activarla

Un custom node es código Python que se ejecuta al iniciar ComfyUI, con los permisos del usuario que inicia el servidor: puede leer sus archivos, los tokens de sesión del navegador y sus monederos, y llamar a Internet. No es algo teórico. En enero de 2026, el repositorio oficial de ComfyUI documentó una serie de nodos publicados en Comfy Registry con el nombre «Upscaler_4K», que instalaban un ladrón de datos dirigido a navegadores, monederos de criptomonedas y tokens de Discord. En abril de 2026, una campaña descrita por Censys tenía como objetivo las instancias de ComfyUI expuestas en Internet mediante custom nodes que ejecutan código sin autenticación.

El Manager integra una protección: un nivel de seguridad, configurado mediante la clave security_level de su archivo config.ini. El repositorio del Manager documenta cuatro valores: strong, normal (valor predeterminado), normal- y weak. El nivel predeterminado bloquea las acciones más arriesgadas, como instalar desde una URL de Git arbitraria o instalar paquetes pip bajo demanda, y las restricciones se endurecen cuando ComfyUI se inicia con --listen en una dirección no local. El nivel weak elimina todas las barreras: actívelo solo durante una operación concreta, en una máquina que no escuche en la red, y vuelva después a normal. La tabla exacta de acciones permitidas por nivel figura en el README del Manager, que prevalece en caso de duda.

Usar el catálogo, no un enlace

Las extensiones del catálogo y del Registry están al menos identificadas y pueden retirarse si se notifica un problema. Un enlace de descarga directa o un repositorio sin historial no lo está.

Ver el autor, el historial y las estrellas

Un repositorio creado la semana pasada, con dos commits, ninguna issue y un nombre que imita una extensión conocida es el perfil típico de un nodo trampa. Las estrellas por sí solas no demuestran nada, pero una extensión realmente utilizada tiene estrellas y issues abiertas.

Desconfía de las promesas

Agrandador milagroso, modelo comercial «desbloqueado», workflow que exige una única extensión imposible de encontrar en otro sitio: recházalos por defecto.

Leer el requirements.txt

Antes de instalar una extensión desconocida, abra su repositorio y lea la lista de dependencias. Los paquetes sin relación con la imagen (acceso al navegador, red de bajo nivel, compresión de archivos exóticos) son una señal de alerta.

No exponga nunca ComfyUI sin protección

Sin --listen, ComfyUI solo escucha en 127.0.0.1. Si debe abrirlo a la red, coloque delante un proxy inverso con contraseña o una VPN, y mantenga security_level en normal.

#Actualizar sin romperlo todo

La actualización es la segunda fuente de fallos después de la instalación. ComfyUI evoluciona rápido, las extensiones van a la zaga y Update All lo aplica todo de una vez. Tres hábitos evitan perder una mañana.

1. 01
   Crear una instantánea antes

   Snapshot Manager y, después, Save snapshot. El Manager guarda la revisión de ComfyUI, la de cada extensión y la lista de paquetes Python en su carpeta snapshots. Si la actualización rompe un workflow, Restore devuelve todo a ese estado después de reiniciar.
2. 02
   Actualizar una extensión cada vez

   En el catálogo, filtre por Update y actualice primero la extensión que necesita. Pruebe el workflow correspondiente. Update All sigue siendo útil en una instalación sencilla, pero después de crear una instantánea.
3. 03
   Actualizar ComfyUI por separado

   El botón Update ComfyUI actualiza el núcleo. Úsalo cuando una extensión lo exija, no por costumbre: cada actualización del núcleo puede romper extensiones sin mantenimiento; el propio README de ComfyUI advierte que los commits más recientes pueden romper muchas.

En ComfyUI Desktop, la aplicación actualiza el núcleo y sigue la versión estable; allí el Manager solo sirve para las extensiones. La versión portátil y la instalación manual, que siguen los últimos commits, tienen la instantánea como única red de seguridad. Un workflow que funciona vale más que una versión más reciente.

#Para ir más allá

El Manager resuelve los problemas de las extensiones; no sustituye la comprensión del grafo. Las guías siguientes cubren el resto de la cadena, desde la instalación de ComfyUI hasta los usos que requieren custom nodes.

• ComfyUI: instalación y primeros pasos en local
• ControlNet: componer imágenes, el uso típico de los custom nodes
• Generar imágenes en local: panorama de las herramientas
• Fooocus: la alternativa sin nodos ni extensiones

Fuentes oficiales consultadas para esta guía: la página del Manager y la de instalación de custom nodes en la documentación de ComfyUI, la página de solución de problemas de los custom nodes, así como el README del repositorio ComfyUI-Manager para los niveles de seguridad. Las etiquetas de menú citadas corresponden a la interfaz del Manager tal como se describe en esas páginas; pueden variar de una versión a otra.

• Documentación de ComfyUI: la interfaz de Manager
• Documentación de ComfyUI: instalar un custom node
• Documentación de ComfyUI: solucionar problemas de los custom nodes
• Repositorio ComfyUI-Manager (README, niveles de seguridad)