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érant4x-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/.safetensorsdansComfyUI/models/upscale_models/(ou de fournir un--workflowpersonnalisé).
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éfinissezIsDaemon: truepour 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
- Prévention de Boucles Infinies :
- Chaque job d'upscale soumis est étiqueté avec
extra_data.auto_upscale_generated = trueet suivi parprompt_id. - Les sorties sont sauvegardées dans
upscaled/(filename_prefix = "upscaled/upscaled"par défaut) et les deux scripts ignorent automatiquement les images dansupscaled/ou correspondant aux préfixesupscaled_.
- Chaque job d'upscale soumis est étiqueté avec
- Garde-fou OOM / Sur-upscale :
- Les images dont le côté le plus long dépasse
--max-input-side(par défaut2048px) sont automatiquement ignorées. Passez--max-input-side 0pour désactiver.
- Les images dont le côté le plus long dépasse
- Pas d'Inondation Rétroactive au Démarrage du Watcher :
watch_upscale.pycapture 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
0et affiche[UPSCALED] <source> -> upscaled/.... - Pour les exécutions du watcher, effectuez un test rapide
--once --dry-runou vérifiez le journal du démon pourEn 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.