La contradicción entre el instalador y el verificador en ComfyUI

Al configurar un entorno de ComfyUI, es común ejecutar comandos para descargar modelos y verificar nodos. Sin embargo, en una sesión reciente apareció una ligera contradicción que merecía atención: el instalador aseguraba tener todos los archivos necesarios, pero el verificador informaba que faltaban cuatro.

Salida de terminal mostrando error de comprobación de nodos en ComfyUI
El verificador reporta archivos faltantes a pesar de que el instalador dice que todo está presente.

La situación comenzó ejecutando pnpm models:download con los workflows minimax-h3, minimax-music3 y upscale. La salida indicaba claramente: ‘9 of 9 file(s) already present’ y ‘All files in place’. No obstante, al ejecutar pnpm check:nodes, el sistema respondía con ‘4 model file(s) missing’ y un código de salida 1.

El problema está en la selección de workflows

Analizando detenidamente la salida, se detectó que los archivos faltantes no correspondían a los tres workflows solicitados. El instalador parece calcular los archivos necesarios basándose en una lista específica de los flujos elegidos, mientras que el verificador comprueba una lista global de modelos conocidos por el proyecto.

Los cuatro archivos ausentes se asignaban a otros flujos:

  • minimax_h3_ref2va_bf16.safetensors: Necesario para minimax-h3-ref.
  • qwen3vl_32b_minimax_h3_bf16.safetensors: Necesario para minimax-h3-ref.
  • flux1-kontext-dev.safetensors: Necesario para image-edit.
  • t5xxl_fp8_e4m3fn.safetensors: Necesario para image-edit.

Esto sugiere que el instalador reconoce parte de las selecciones, pero el verificador valida independientemente de los filtros aplicados.

Análisis de los scripts

Antes de descargar decenas de gigabytes innecesariamente, la recomendación es revisar los scripts TypeScript directamente:

  • I:sorantscriptsdownload-models.ts
  • I:sorantscriptscheck-nodes.ts

Es necesario buscar cómo se construye la lista de modelos en el script de descarga y si --workflows filtra correctamente esa lista. La hipótesis es que el verificador está haciendo una validación global, no restringida a los workflows seleccionados.

Esquema lógico de discrepancia entre scripts de descarga y verificación
La lógica de los scripts valida listas diferentes según el flujo de trabajo seleccionado.

El objetivo final es determinar si existe un error de lógica en el instalador o simplemente una diferencia entre las dependencias declaradas por ambos scripts. Con esa información, se puede evitar descargar archivos no requeridos y ajustar la configuración del entorno con precisión.