Solucionar ComfyUI Manager que no reconoce Custom Nodes instalados

Has instalado custom nodes en ComfyUI, están justo ahí en tu carpeta custom_nodes, pero ComfyUI Manager tercamente los muestra como "no instalados". Haces clic en instalar de nuevo y crea duplicados. O intentas actualizar pero dice que no hay nada que actualizar aunque sabes que existen nuevas versiones.

Respuesta rápida: ComfyUI Manager no reconoce los nodos instalados típicamente debido a desincronización de la base de datos, métodos de instalación incorrectos o conflictos de metadatos en caché. La solución generalmente implica limpiar la caché de la base de datos de nodos del Manager, asegurar que los nodos fueron instalados a través del Manager en lugar de git clone manual, y verificar que la estructura de carpetas coincide con las expectativas del Manager. Un reinicio del Manager o reconstrucción de la base de datos resuelve la mayoría de los casos en minutos.

Este problema está entre las frustraciones más comunes de ComfyUI reportadas por usuarios. Es particularmente molesto porque tus nodos funcionan perfectamente en los workflows. Cargan bien, se ejecutan sin errores, pero Manager piensa que no existen. Vamos a arreglar esto sistemáticamente.

¿Por qué ComfyUI Manager no reconoce los nodos?

Entender la causa raíz te ayuda a arreglar esto correctamente y prevenir que vuelva a ocurrir.

Cómo Manager rastrea las instalaciones

ComfyUI Manager no solo mira tu carpeta custom_nodes. Mantiene una base de datos interna que rastrea qué ha instalado, de dónde y qué versión. Esta base de datos vive en la estructura de directorios propia del Manager.

Cuando clonas manualmente un repositorio de nodos usando git, el nodo funciona porque ComfyUI mismo simplemente escanea archivos Python en custom_nodes. Pero Manager no sabe nada porque nada actualizó la base de datos del Manager.

Lo inverso también ocurre. Si la base de datos del Manager dice que algo está instalado pero la carpeta fue eliminada o movida, Manager lo muestra como instalado cuando en realidad falta.

Causas comunes de desincronización

Operaciones manuales de git son la causa principal. Clonar, hacer pull o eliminar carpetas de nodos sin pasar por Manager rompe su seguimiento.

Instalaciones fallidas pueden dejar entradas parciales en la base de datos. Manager intentó instalar algo, falló a mitad del proceso, pero lo registró como instalado antes del fallo.

Mover o copiar instalaciones de ComfyUI a menudo deja la base de datos del Manager apuntando a rutas incorrectas o con información obsoleta sobre el sistema anterior.

Actualizaciones del Manager ocasionalmente introducen cambios en el esquema de la base de datos. Los formatos de base de datos antiguos pueden no parsearse correctamente después de actualizar el Manager mismo.

Interferencia del antivirus a veces elimina archivos durante la instalación pero después de que Manager registra la instalación como completa. Manager piensa que tuvo éxito pero los archivos desaparecieron.

La capa de caché

Manager también almacena en caché metadatos de nodos como actualizaciones disponibles e información del repositorio. Esta caché puede volverse obsoleta o corromperse, mostrando estados desactualizados o incorrectos incluso cuando la base de datos subyacente es correcta.

Los problemas de caché causan síntomas como que "actualización disponible" nunca aparezca, o números de versión incorrectos mostrándose en la interfaz del Manager.

¿Cómo solucionas los problemas de reconocimiento de nodos?

Comienza con las soluciones más simples y escala si es necesario.

Solución 1: Reiniciar ComfyUI completamente

A veces Manager solo necesita una inicialización fresca. Cierra ComfyUI completamente - no solo refrescar, sino detener el proceso de Python.

Espera unos segundos para que se liberen los handles de archivo, luego inicia ComfyUI de nuevo. Manager se reinicializa al inicio y puede detectar nodos que pasó por alto durante una sesión de larga duración.

Este simple paso arregla el problema aproximadamente el 20% de las veces sin ningún riesgo.

Solución 2: Forzar reconstrucción de la base de datos del Manager

Manager tiene una función incorporada para reconstruir su base de datos de nodos desde el estado del sistema de archivos.

Abre Manager en ComfyUI haciendo clic en el botón Manager. Navega a configuración u opciones avanzadas. Busca una opción etiquetada "Reconstruir base de datos" o "Reescanear nodos".

Hacer clic en esto fuerza a Manager a escanear el directorio custom_nodes de nuevo y reconstruir sus registros de instalación. Cualquier nodo presente será detectado y registrado correctamente.

Después de reconstruir, reinicia ComfyUI para que los cambios tomen efecto completo.

Solución 3: Limpiar la caché de la base de datos de nodos

Si reconstruir no ayuda, limpia los archivos de caché manualmente. Navega a tu directorio de instalación de ComfyUI.

Encuentra la carpeta ComfyUI-Manager dentro de custom_nodes. Dentro de la carpeta de Manager, busca archivos nombrados como node_db.json, cache.json, o archivos de base de datos similares.

Elimina estos archivos de caché. No te preocupes, se recrearán automáticamente cuando Manager reinicie. La base de datos fresca reflejará con precisión tus instalaciones actuales.

Reinicia ComfyUI después de eliminar los archivos de caché. Manager tardará un poco más en la primera carga mientras reconstruye todo desde cero.

Solución 4: Reinstalar nodos problemáticos a través del Manager

Para nodos que clonaste manualmente, la solución más limpia es reinstalar a través del Manager.

Primero, elimina la carpeta clonada manualmente de custom_nodes. No solo la renombres ya que eso puede causar otros problemas.

Luego usa la interfaz de Instalar Custom Nodes del Manager para instalar el mismo nodo. Manager lo clonará correctamente y lo registrará en su base de datos.

Este enfoque asegura que Manager tenga seguimiento completo y pueda manejar actualizaciones, dependencias y eliminación correctamente en el futuro.

Solución 5: Verificar nombres de carpetas

Manager espera nombres de carpetas específicos que coincidan con nombres de repositorios. Si renombraste una carpeta de nodo, Manager no puede asociarla con su entrada en la base de datos.

Verifica que los nombres de carpetas coinciden con lo que Manager espera. El repositorio ComfyUI-Impact-Pack debería tener una carpeta nombrada exactamente ComfyUI-Impact-Pack, no Impact-Pack ni nada abreviado.

Si renombraste carpetas, renómbralas de vuelta o reinstala a través del Manager para obtener los nombres correctos automáticamente.

Solución 6: Verificar estado del repositorio Git

Manager usa git para rastrear versiones y actualizaciones. Si la carpeta .git dentro de un nodo falta o está corrupta, Manager no puede determinar el estado de instalación.

Navega dentro de la carpeta de un nodo problemático y verifica si hay un directorio .git. Si falta, el nodo no será rastreado correctamente.

Puedes intentar ejecutar git init seguido de configurar el remoto al repositorio original, pero reinstalar a través del Manager es usualmente más simple.

Solución 7: Verificar instalaciones duplicadas

A veces el mismo nodo se instala dos veces con pequeñas variaciones de nombre. Manager podría estar rastreando uno mientras ComfyUI carga el otro.

Busca duplicados en tu carpeta custom_nodes. Busca carpetas con nombres similares o funcionalidad de nodo idéntica. Elimina duplicados, quedándote solo con el instalado a través del Manager.

Patrones comunes de duplicación incluyen tener tanto el nombre original del repositorio como una versión renombrada, o tanto una rama de release como una rama de desarrollo del mismo nodo.

¿Qué pasa si los nodos muestran números de versión incorrectos?

Los problemas de detección de versión están relacionados pero son distintos de la detección de instalación.

Mecanismo de seguimiento de versiones

Manager verifica tags y commits de git para determinar versiones. Si un repositorio de nodos no usa etiquetado de versión adecuado, Manager muestra versiones "desconocidas" o incorrectas.

Esto no es algo que puedas arreglar para nodos que no creaste. El desarrollador del nodo necesita usar tags de git correctamente.

Obsolescencia de caché

Más comúnmente, las versiones incorrectas resultan de metadatos en caché. Limpia la caché del Manager como se describe arriba para forzar verificaciones de versión frescas.

Después de limpiar la caché, Manager obtiene el estado actual del repositorio desde GitHub o GitLab. Esto toma un momento pero proporciona información de versión precisa.

Problemas de red

Si Manager no puede alcanzar los hosts de repositorios, muestra versiones obsoletas. Verifica tu conectividad de red y cualquier regla de firewall que bloquee operaciones git.

Las redes corporativas a menudo bloquean protocolos git. Si estás en una red restringida, Manager no puede actualizar su conocimiento de versiones disponibles.

¿Cómo previenes este problema en el futuro?

Las buenas prácticas mantienen Manager y tus nodos sincronizados permanentemente.

Siempre instalar a través del Manager

Incluso cuando tienes una URL de GitHub y conoces git, usa la interfaz del Manager. Pega la URL en el campo de instalación personalizada del Manager en lugar de clonar manualmente.

Esto asegura el registro apropiado en la base de datos desde el inicio. La clonación manual solo debería ocurrir cuando estás depurando o desarrollando nodos.

Usar Manager para actualizaciones

Cuando los nodos tienen actualizaciones disponibles, usa la función de actualización del Manager en lugar de ejecutar git pull tú mismo.

La actualización del Manager maneja actualizaciones de dependencias, seguimiento de versión de la base de datos, y hooks post-actualización que los pulls manuales omiten.

Evitar manipulación directa de carpetas

No elimines, renombres ni muevas carpetas de nodos manualmente. Usa la función de desinstalación del Manager para eliminar nodos limpiamente.

Si debes manipular carpetas directamente, espera reconstruir la base de datos del Manager después.

Actualizaciones regulares del Manager

Mantén el Manager mismo actualizado. Las versiones más nuevas arreglan bugs en el manejo de la base de datos y mejoran la detección de nodos.

Actualiza Manager primero cuando estés solucionando problemas de nodos ya que la solución puede ya existir en una versión más nueva del Manager.

Para usuarios que quieren capacidades de ComfyUI sin gestionar estos detalles técnicos, Apatero.com proporciona infraestructura mantenida profesionalmente. Los nodos siempre están correctamente instalados, actualizados y configurados sin ninguno de estos dolores de cabeza de sincronización.

¿Qué hay de los problemas específicos de reconocimiento de nodos?

Algunos nodos tienen problemas únicos de reconocimiento que vale la pena abordar específicamente.

Reconocimiento de Impact Pack

ComfyUI-Impact-Pack es complejo con muchas dependencias. Los problemas de reconocimiento a menudo provienen de problemas con submódulos.

Asegúrate de que la carpeta impact_pack_models existe y contiene los archivos requeridos. Impact Pack no se mostrará como correctamente instalado si faltan sus archivos de modelo aunque el código esté presente.

Usa el instalador incorporado de Impact Pack para sus dependencias en lugar de la instalación genérica del Manager. Esto maneja los archivos de modelo correctamente.

Problemas del preprocesador ControlNet

ComfyUI-ControlNet-AUX requiere descargas de modelos después de la instalación. Manager lo marca como instalado inmediatamente, pero no está realmente listo hasta que los modelos se descarguen.

Si los nodos de preprocesamiento dan error, ejecuta los scripts de descarga de modelos o deja que se descarguen en el primer uso. El nodo está instalado según Manager, solo incompleto.

Reconocimiento de Video Helper Suite

VideoHelperSuite tiene dependencias específicas de ffmpeg que afectan el reconocimiento. Si ffmpeg no es accesible correctamente, Manager puede mostrar estado de instalación parcial.

Verifica que ffmpeg está en tu PATH del sistema y accesible desde la línea de comandos. Luego reconstruye la base de datos del Manager.

Preguntas frecuentes

¿Por qué Manager muestra "Actualizar" para un nodo que acabo de instalar?

Esto ocurre cuando instalaste desde una rama de desarrollo pero Manager verifica la rama principal para actualizaciones. Los números de versión no coinciden, así que Manager ve una actualización disponible. Generalmente es seguro ignorarlo o puedes actualizar para sincronizar con la rama principal.

¿Puedo usar tanto Manager como clones manuales de git juntos?

Técnicamente sí, pero los clones manuales no aparecerán en la interfaz del Manager. Funcionarán en ComfyUI pero Manager no los rastreará. Para la experiencia más limpia, elige un método y quédate con él.

¿Reconstruir la base de datos romperá mis workflows?

No, la reconstrucción de la base de datos solo afecta el seguimiento del Manager. Tus workflows, prompts guardados y configuraciones de nodos permanecen intactos. Todo funcionará exactamente como antes, solo con estado preciso del Manager.

¿Por qué algunos nodos aparecen múltiples veces en la lista del Manager?

Esto indica múltiples instalaciones, a menudo de intentos de instalación fallidos que dejaron entradas parciales en la base de datos. Limpia la base de datos, elimina todas las copias del nodo duplicado, luego reinstala una vez a través del Manager.

¿Cómo sé si un nodo fue instalado a través del Manager o manualmente?

Los nodos instalados por Manager aparecen en la lista de Nodos Instalados con información apropiada de versión y actualización. Los nodos clonados manualmente o no aparecen en absoluto o muestran versión "Desconocida" sin capacidad de actualización.

¿Esto afecta mi capacidad de usar los nodos en workflows?

No, los problemas de reconocimiento de nodos son puramente un problema del Manager. ComfyUI mismo escanea la carpeta custom_nodes independientemente y carga lo que encuentra. Tus workflows funcionarán independientemente del estado de reconocimiento del Manager.

¿Por qué Manager dice "no hay nodos instalados" cuando tengo docenas?

Esto indica corrupción o pérdida completa de la base de datos. Tus nodos están bien y funcionando. Limpia los archivos de caché del Manager completamente y reconstruye la base de datos desde cero. Todo será detectado.

¿Puedo respaldar la base de datos del Manager antes de solucionar problemas?

Sí, copia los archivos json de la carpeta del Manager antes de eliminarlos. Si algo sale mal puedes restaurarlos. Sin embargo, dado que estos archivos son exactamente lo que estás solucionando, restaurarlos también restauraría el problema.

¿Qué pasa si el mismo problema sigue recurriendo?

Los problemas recurrentes usualmente indican un problema de flujo de trabajo como reinstalar nodos manualmente entre reconstrucciones del Manager. Verifica tus hábitos y asegúrate de que estás usando Manager consistentemente para todas las operaciones de nodos.

¿Debería reportar bugs de reconocimiento al GitHub del Manager?

Si has intentado todas las soluciones y el problema persiste, sí. Incluye tu versión de ComfyUI, versión del Manager, sistema operativo, y nodos específicos afectados. Los desarrolladores pueden identificar si es un bug conocido o un problema nuevo.

Conclusión y estrategia de prevención

Los problemas de reconocimiento de nodos de ComfyUI Manager provienen casi enteramente de la desincronización entre su base de datos y tu sistema de archivos actual. La solución es directa ya que necesitas forzar la sincronización a través de la reconstrucción de la base de datos y limpieza de caché.

Comienza con un simple reinicio. Si eso no funciona, reconstruye la base de datos. Para problemas persistentes, limpia todos los archivos de caché y deja que Manager los recree frescos.

En adelante, comprométete a usar Manager para todas las operaciones de nodos. Instala a través del Manager, actualiza a través del Manager, y elimina a través del Manager. Esto mantiene todo sincronizado permanentemente.

Los pocos minutos gastados solucionando problemas ahora ahorran horas de frustración futura. Una vez que la base de datos de tu Manager refleja con precisión tus instalaciones, las actualizaciones funcionan suavemente, las dependencias se resuelven correctamente, y puedes confiar en los indicadores de estado del Manager.

Para usuarios que prefieren no lidiar con estas tareas de gestión técnica, Apatero.com maneja toda la instalación y mantenimiento de nodos automáticamente. Obtienes acceso a nodos correctamente configurados sin preocupaciones de sincronización de base de datos o solución manual de problemas.

Mantén Manager actualizado, úsalo consistentemente, y estos problemas de reconocimiento se convertirán en cosa del pasado.