CommunityImagengithub.com

comfyui-auto-upscale

Escala automáticamente las imágenes generadas por ComfyUI a través de su API HTTP/WebSocket. Útil para escalar la última imagen generada, un lote de imágenes o ejecutar un vigilante de fondo que escala cada nueva imagen automáticamente.

¿Qué es comfyui-auto-upscale?

ComfyUI Auto-Upscale es una skill diseñada para escalar imágenes automáticamente después de que ComfyUI las genere, utilizando scripts de Python con la biblioteca estándar. Soporta múltiples modos: escalado on-demand de la última imagen o lote de imágenes, y un vigilante de fondo que escala cada nueva imagen en cuanto ComfyUI termina de generarla. La skill ofrece salvaguardas incorporadas como prevención de bucles infinitos, protección contra sobre-escalado y memoria, y evita el re-procesamiento retroactivo al iniciar el vigilante. Es compatible con modelos de escalado integrados (como 4x-UltraSharp y RealESRGAN) y flujos de trabajo personalizados en formato API de ComfyUI (como Ultimate SD Upscale, Tiled Diffusion o SUPIR), lo que la hace flexible para diferentes necesidades de escalado de imágenes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/HomlesRichard/comfyui-auto-upscale/tree/HEAD

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 (prefiriendo 4x-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/.safetensors en ComfyUI/models/upscale_models/ (o que proporcione un --workflow personalizado).

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, establece IsDaemon: true para 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

  1. Prevención de Bucles Infinitos:
    • Cada trabajo de escalado enviado se etiqueta con extra_data.auto_upscale_generated = true y se rastrea por prompt_id.
    • Las salidas se guardan en upscaled/ (filename_prefix = "upscaled/upscaled" por defecto) y ambos scripts ignoran automáticamente las imágenes en upscaled/ o que coincidan con prefijos upscaled_.
  2. Protección Contra OOM / Sobre-Escalado:
    • Las imágenes cuyo lado más largo supere --max-input-side (predeterminado 2048 px) se omiten automáticamente. Pasa --max-input-side 0 para desactivar.
  3. Sin Inundación Retroactiva al Iniciar el Vigilante:
    • watch_upscale.py toma 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 0 e imprima [UPSCALED] <origen> -> upscaled/....
  • Para ejecuciones del vigilante, realiza una prueba rápida --once --dry-run o verifica el registro del demonio para Waiting for new images... y confirma que generar una imagen en ComfyUI active exactamente una entrada [Upscaled OK] sin re-activarse.

Skills relacionados