Desenredando el H3 Latent Upscaler en ComfyUI: Versiones, Nodos y la Realidad del Debugging

El uso de herramientas como el H3 Latent Upscaler en ComfyUI puede resultar en una experiencia frustrante si no se entiende la arquitectura detrás de los nodos. He estado lidiando con una confusión particular: tenía un workflow que funcionaba bien, pero al intentar usar ese mismo nodo dos versiones más tarde, o al copiar y pegar el código, todo fallaba. Incluso después de buscar en GitHub e instalar lo que parecía ser la versión oficializada del nodo, el proceso se interrumpía con errores si no seleccionaba específicamente un upscaler de la familia MiniMax.

La raíz del problema es que el ecosistema de nodos para el upscaler H3 ha cambiado drásticamente en poco tiempo. No se trata solo de un error de instalación, sino de una evolución rápida donde los repositorios han alterado nombres de nodos y arquitecturas. El nodo original que funcionaba utilizaba un checkpoint 3D específico, mientras que la versión instalada ahora tiene una estructura diferente. Esto provoca que el selector de opciones parezca permitir usar modelos como LTX, pero intentar sustituir el modelo H3 por uno genérico termina en errores.

Es fundamental entender que el upscaler LTX y el upscaler H3 latent operan en niveles completamente distintos; uno es espacial y el otro está entrenado para el formato de 24 canales del latent H3. Por eso, la idea conceptual es usar a LTX como inspiración, no como sustituto directo.

Autopsia del Workflow: Comparando Estado Anterior vs. Actual

En lugar de seguir instalando versiones a ciegas, es necesario realizar una autopsia del workflow original para ver qué ha cambiado realmente. Al comparar el JSON del workflow antiguo con la versión actual, se puede identificar rápidamente si el nombre de la clase (`class_type`) o el ID del nodo han sido modificados.

Además, la pregunta sobre si ComfyUI debería cargar automáticamente los nodos en `custom_nodes` tiene una respuesta técnica clara. El sistema escanea el directorio e importa los módulos, pero si durante la importación se produce una excepción—como un archivo de inicialización roto o un módulo faltante—el paquete queda sin registrar y el nodo no aparece.

La solución práctica es regresar al estado exacto que funcionaba: ComfyUI 0.32 junto con la versión específica del custom node y el checkpoint original, antes de intentar actualizar nada más. Esto permite aislar las variables y confirmar si el problema reside en la incompatibilidad de versiones o en una mala importación de los archivos.