CommunityImagegithub.com

comfyui-auto-upscale

Met à l'échelle automatiquement les images générées par ComfyUI via l'API HTTP/WebSocket. Utilisez cette compétence lorsque l'utilisateur souhaite agrandir les dernières images générées par ComfyUI à la demande, traiter par lot un dossier d'images générées, ou exécuter un observateur en arrière-plan qui agrandit automatiquement chaque nouvelle image dès que ComfyUI a fini de la générer.

Qu'est-ce que comfyui-auto-upscale ?

Cette compétence permet d'automatiser la mise à l'échelle (upscaling) des images générées par ComfyUI, soit à la demande, soit en continu via un watcher. Elle supporte les modèles intégrés (comme 4x-UltraSharp, RealESRGAN) et les workflows personnalisés au format API de ComfyUI (Ultimate SD Upscale, Tiled Diffusion, SUPIR). Les scripts en Python pur utilisent des mécanismes de sécurité tels que la prévention des boucles infinies (tag des jobs avec `extra_data.auto_upscale_generated` et surveillance des préfixes `upscaled/`), un garde-fou contre l'épuisement mémoire (taille maximale d'entrée paramétrable), et une protection contre les inondations rétroactives au démarrage du watcher. La compétence fonctionne via deux scripts principaux : `upscale_image.py` pour l'upscaling immédiat, et `watch_upscale.py` pour un mode démon en arrière-plan. Elle est compatible avec les environnements locaux et distants grâce à l'API HTTP/WebSocket de ComfyUI, et permet une configuration flexible via fichiers JSON et options CLI.

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

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

ComfyUI Auto-Upscale

Met automatiquement à l'échelle les images après que ComfyUI a fini de les générer, en utilisant des scripts Python en stdlib pure avec prévention intégrée des boucles infinies et garde-fous de résolution.

Prérequis et Vérification Préliminaire

Vérifiez toujours la connectivité de ComfyUI et découvrez les modèles d'upscale installés en premier :

python scripts/upscale_image.py --check --server http://127.0.0.1:8188
  • Si ComfyUI fonctionne sur un autre hôte ou port, utilisez --server http://<host>:<port>.
  • Notez les modèles installés retournés sous Installed upscale models. Si l'utilisateur ne spécifie pas de modèle, les scripts sélectionnent automatiquement le meilleur modèle installé (en préférant 4x-UltraSharp.pth, RealESRGAN_x4plus.pth, etc.).
  • Si la liste est vide et que l'utilisateur souhaite utiliser l'upscaling intégré, demandez-lui de placer un modèle d'upscale .pth/.safetensors dans ComfyUI/models/upscale_models/ (ou de fournir un --workflow personnalisé).

Mode 1 : Upscaling à la Demande

Utilisez upscale_image.py lorsque l'utilisateur souhaite agrandir immédiatement des images déjà générées.

Mettre à l'échelle la ou les dernières images générées depuis l'historique de ComfyUI

# Mettre à l'échelle l'image non agrandie la plus récente
python scripts/upscale_image.py --latest

# Mettre à l'échelle les 4 dernières images générées, en réduisant la sortie 4x par 0.5 pour un résultat net 2x
python scripts/upscale_image.py --latest 4 --scale-by 0.5

# Utiliser un modèle installé spécifique et aussi sauvegarder une copie locale
python scripts/upscale_image.py --latest 1 --model 4x-UltraSharp.pth --save-dir ./upscaled_out

Mettre à l'échelle une ou plusieurs images locales spécifiques ou un dossier

# Fichier unique ou multiple
python scripts/upscale_image.py --image path/to/gen_0001.png

# Mettre à l'échelle par lot toutes les images non agrandies dans un répertoire
python scripts/upscale_image.py --dir path/to/ComfyUI/output

Prévisualisation avant exécution (Validation)

Utilisez --dry-run (et éventuellement --json pour une sortie structurée) pour vérifier les images cibles, les dimensions et la sélection du modèle sans rien mettre en file d'attente dans ComfyUI :

python scripts/upscale_image.py --latest --dry-run --json

Mode 2 : Observateur Automatique Post-Génération

Utilisez watch_upscale.py pour exécuter un démon en arrière-plan qui agrandit automatiquement chaque nouvelle image juste après que ComfyUI a fini de la générer.

Lors du démarrage du watcher via run_command, définissez IsDaemon: true pour qu'il reste en arrière-plan pendant que l'utilisateur génère des images dans ComfyUI.

Option A : Surveiller l'API ComfyUI (Recommandé — fonctionne localement et à distance)

# Utilise automatiquement WebSocket si websocket-client est installé, sinon retombe sur un polling /history léger
python scripts/watch_upscale.py --mode comfyui --server http://127.0.0.1:8188

# Forcer le polling HTTP pure-stdlib toutes les 1,5 secondes avec un préfixe personnalisé et une sortie cible 2x
python scripts/watch_upscale.py --mode comfyui --transport poll --interval 1.5 --scale-by 0.5 --prefix "upscaled/{stem}_hd"

Option B : Surveiller un Répertoire de Sortie Local

python scripts/watch_upscale.py --mode folder --watch-dir "D:/ComfyUI/output" --server http://127.0.0.1:8188

Configuration Réutilisable

Copiez config.example.json vers un fichier de configuration local (par exemple, my_upscale_config.json) et passez --config my_upscale_config.json à l'un ou l'autre script. Les options CLI écrasent toujours les valeurs du fichier de configuration.

Workflows Personnalisés (Ultimate SD Upscale, Tiled Diffusion, SUPIR, etc.)

Pour utiliser un workflow d'upscale/hires-fix personnalisé de ComfyUI au lieu du modèle intégré :

python scripts/watch_upscale.py --workflow path/to/upscale_api.json --input-node-id 1

Consultez references/custom-workflows.md pour exporter du JSON au format API, gérer plusieurs nœuds LoadImage et résoudre les problèmes.

Garde-fous Intégrés

  1. Prévention de Boucles Infinies :
    • Chaque job d'upscale soumis est étiqueté avec extra_data.auto_upscale_generated = true et suivi par prompt_id.
    • Les sorties sont sauvegardées dans upscaled/ (filename_prefix = "upscaled/upscaled" par défaut) et les deux scripts ignorent automatiquement les images dans upscaled/ ou correspondant aux préfixes upscaled_.
  2. Garde-fou OOM / Sur-upscale :
    • Les images dont le côté le plus long dépasse --max-input-side (par défaut 2048 px) sont automatiquement ignorées. Passez --max-input-side 0 pour désactiver.
  3. Pas d'Inondation Rétroactive au Démarrage du Watcher :
    • watch_upscale.py capture l'historique / le contenu du dossier de ComfyUI au démarrage et ne traite que les nouvelles images générées ensuite.

Vérification

  • Pour les exécutions à la demande, confirmez que la commande se termine avec le code 0 et affiche [UPSCALED] <source> -> upscaled/....
  • Pour les exécutions du watcher, effectuez un test rapide --once --dry-run ou vérifiez le journal du démon pour En attente de nouvelles images... et vérifiez que la génération d'une image dans ComfyUI déclenche exactement une entrée [Upscaled OK] sans redéclenchement.

Skills associés