ComfyUI Auto-Upscale
Escala automáticamente las imágenes después de que ComfyUI termine de generarlas, usando scripts de Python de biblioteca estándar con prevención de bucles infinitos y protecciones de resolución.
Prerrequisitos y Verificación Previa
Siempre verifica la conectividad de ComfyUI y descubre los modelos de escalado instalados primero:
python scripts/upscale_image.py --check --server http://127.0.0.1:8188
- Si ComfyUI se ejecuta en otro host o puerto, pasa
--server http://<host>:<puerto>. - Anota los modelos instalados devueltos bajo
Installed upscale models. Si el usuario no especifica un modelo, los scripts seleccionan automáticamente el mejor modelo instalado (prefiriendo4x-UltraSharp.pth,RealESRGAN_x4plus.pth, etc.). - Si la lista está vacía y el usuario desea escalar con modelo integrado, indícale que coloque un modelo
.pth/.safetensorsenComfyUI/models/upscale_models/(o que proporcione un--workflowpersonalizado).
Modo 1: Escalado Bajo Demanda
Usa upscale_image.py cuando el usuario quiera escalar imágenes ya generadas de inmediato.
Escalar la(s) última(s) imagen(es) generada(s) del historial de ComfyUI
# Escalar la única imagen más reciente no escalada
python scripts/upscale_image.py --latest
# Escalar las últimas 4 imágenes generadas, reduciendo la salida 4x por 0.5 para un resultado nítido 2x
python scripts/upscale_image.py --latest 4 --scale-by 0.5
# Usar un modelo específico instalado y también guardar una copia local
python scripts/upscale_image.py --latest 1 --model 4x-UltraSharp.pth --save-dir ./upscaled_out
Escalar imágenes locales específicas o una carpeta
# Archivo único o múltiples archivos
python scripts/upscale_image.py --image ruta/a/gen_0001.png
# Escalar en lote todas las imágenes no escaladas en un directorio
python scripts/upscale_image.py --dir ruta/a/ComfyUI/output
Vista previa antes de ejecutar (Validación)
Usa --dry-run (y opcionalmente --json para salida estructurada) para verificar imágenes objetivo, dimensiones y selección de modelo sin encolar nada en ComfyUI:
python scripts/upscale_image.py --latest --dry-run --json
Modo 2: Vigilante Automático Post-Generación
Usa watch_upscale.py para ejecutar un demonio de fondo que escala automáticamente cada nueva imagen justo después de que ComfyUI termine de generarla.
Al iniciar el vigilante mediante
run_command, estableceIsDaemon: truepara que permanezca ejecutándose en segundo plano mientras el usuario genera imágenes en ComfyUI.
Opción A: Vigilar la API de ComfyUI (Recomendado — funciona local y remotamente)
# Usa automáticamente WebSocket si websocket-client está instalado, de lo contrario recurre a sondeo ligero /history
python scripts/watch_upscale.py --mode comfyui --server http://127.0.0.1:8188
# Forzar sondeo HTTP de biblioteca estándar cada 1.5s con un prefijo personalizado y salida 2x
python scripts/watch_upscale.py --mode comfyui --transport poll --interval 1.5 --scale-by 0.5 --prefix "upscaled/{stem}_hd"
Opción B: Vigilar un Directorio de Salida Local
python scripts/watch_upscale.py --mode folder --watch-dir "D:/ComfyUI/output" --server http://127.0.0.1:8188
Configuración Reutilizable
Copia config.example.json a un archivo de configuración local (por ejemplo, my_upscale_config.json) y pasa --config my_upscale_config.json a cualquiera de los scripts. Las banderas de CLI siempre anulan los valores del archivo de configuración.
Flujos de Trabajo Personalizados (Ultimate SD Upscale, Tiled Diffusion, SUPIR, etc.)
Para usar un flujo de trabajo de escalado/arreglo de alta resolución personalizado de ComfyUI en lugar del escalador de modelo integrado:
python scripts/watch_upscale.py --workflow ruta/a/upscale_api.json --input-node-id 1
Consulta references/custom-workflows.md para exportar JSON en formato API, manejar múltiples nodos LoadImage y solucionar problemas.
Salvaguardas de Seguridad Incorporadas
- Prevención de Bucles Infinitos:
- Cada trabajo de escalado enviado se etiqueta con
extra_data.auto_upscale_generated = truey se rastrea porprompt_id. - Las salidas se guardan en
upscaled/(filename_prefix = "upscaled/upscaled"por defecto) y ambos scripts ignoran automáticamente las imágenes enupscaled/o que coincidan con prefijosupscaled_.
- Cada trabajo de escalado enviado se etiqueta con
- Protección Contra OOM / Sobre-Escalado:
- Las imágenes cuyo lado más largo supere
--max-input-side(predeterminado2048px) se omiten automáticamente. Pasa--max-input-side 0para desactivar.
- Las imágenes cuyo lado más largo supere
- Sin Inundación Retroactiva al Iniciar el Vigilante:
watch_upscale.pytoma una instantánea del historial/contenido de la carpeta de ComfyUI al inicio y solo procesa las imágenes nuevas generadas después.
Verificación
- Para ejecuciones bajo demanda, confirma que el comando salga con código
0e imprima[UPSCALED] <origen> -> upscaled/.... - Para ejecuciones del vigilante, realiza una prueba rápida
--once --dry-runo verifica el registro del demonio paraWaiting for new images...y confirma que generar una imagen en ComfyUI active exactamente una entrada[Upscaled OK]sin re-activarse.