ComfyUI Auto-Upscale
ComfyUIが画像を生成した後に自動的にアップスケールします。純粋な標準ライブラリのPythonスクリプトを使用し、ビルトインの無限ループ防止機能と解像度ガードを備えています。
前提条件と事前確認
まずはComfyUIの接続確認とインストール済みアップスケールモデルの検出を行ってください:
python scripts/upscale_image.py --check --server http://127.0.0.1:8188
- ComfyUIが別のホストやポートで動作している場合は、
--server http://<host>:<port>を指定します。 Installed upscale modelsの下に返されるインストール済みモデルを確認します。ユーザーがモデルを指定しない場合、スクリプトは最適なインストール済みモデル(4x-UltraSharp.pth、RealESRGAN_x4plus.pthなどを優先)を自動選択します。- リストが空で、ユーザーがビルトインモデルによるアップスケールを希望する場合は、
ComfyUI/models/upscale_models/に.pth/.safetensorsアップスケールモデルを配置するか、カスタムの--workflowを提供するよう指示してください。
モード1:オンデマンドアップスケール
既に生成された画像を即座にアップスケールしたい場合は upscale_image.py を使用します。
ComfyUI履歴から最新の生成画像をアップスケール
# 最後に生成された未アップスケール画像1枚をアップスケール
python scripts/upscale_image.py --latest
# 最新の4枚の生成画像をアップスケール、4倍出力を0.5倍にダウンスケールしてシャープな2倍結果に
python scripts/upscale_image.py --latest 4 --scale-by 0.5
# 特定のインストール済みモデルを使用し、ローカルコピーも保存
python scripts/upscale_image.py --latest 1 --model 4x-UltraSharp.pth --save-dir ./upscaled_out
特定のローカル画像やフォルダをアップスケール
# 単一または複数ファイル
python scripts/upscale_image.py --image path/to/gen_0001.png
# ディレクトリ内の未アップスケール画像をすべてバッチアップスケール
python scripts/upscale_image.py --dir path/to/ComfyUI/output
実行前プレビュー(検証)
--dry-run(必要に応じて --json で構造化出力)を使用して、ComfyUIにキューを送信せずにターゲット画像、寸法、モデル選択を確認します:
python scripts/upscale_image.py --latest --dry-run --json
モード2:自動ポスト生成監視
watch_upscale.py を使用して、ComfyUIが画像を生成した直後に自動アップスケールを実行するバックグラウンドデーモンを起動します。
run_commandでウォッチャーを起動する場合は、IsDaemon: trueを設定して、ユーザーがComfyUIで画像を生成している間もバックグラウンドで動作し続けるようにします。
オプションA: ComfyUI APIを監視(推奨 — ローカルおよびリモートで動作)
# websocket-clientがインストールされている場合はWebSocketを自動使用、それ以外は軽量な /history ポーリングにフォールバック
python scripts/watch_upscale.py --mode comfyui --server http://127.0.0.1:8188
# 純粋な標準ライブラリHTTPポーリングを1.5秒間隔で強制、カスタムプレフィックスと2倍ターゲット出力
python scripts/watch_upscale.py --mode comfyui --transport poll --interval 1.5 --scale-by 0.5 --prefix "upscaled/{stem}_hd"
オプションB: ローカル出力ディレクトリを監視
python scripts/watch_upscale.py --mode folder --watch-dir "D:/ComfyUI/output" --server http://127.0.0.1:8188
再利用可能な設定
config.example.json をローカル設定ファイル(例:my_upscale_config.json)にコピーし、どちらかのスクリプトに --config my_upscale_config.json を渡します。CLIフラグは常に設定ファイルの値を上書きします。
カスタムワークフロー(Ultimate SD Upscale、Tiled Diffusion、SUPIRなど)
ビルトインモデルアップスケーラの代わりにカスタムComfyUIアップスケール/ハイレゾ修正ワークフローを使用する場合:
python scripts/watch_upscale.py --workflow path/to/upscale_api.json --input-node-id 1
API形式のJSONエクスポート、複数の LoadImage ノードの処理、トラブルシューティングについては references/custom-workflows.md を参照してください。
ビルトインセーフティガード
- 無限ループ防止:
- 送信されたすべてのアップスケールジョブは
extra_data.auto_upscale_generated = trueでタグ付けされ、prompt_idで追跡されます。 - 出力は
upscaled/に保存され(デフォルトでfilename_prefix = "upscaled/upscaled")、両方のスクリプトはupscaled/内の画像やupscaled_プレフィックスに一致する画像を自動的に無視します。
- 送信されたすべてのアップスケールジョブは
- OOM / 過剰アップスケール防止:
- 最長辺が
--max-input-side(デフォルト2048px)を超える画像は自動的にスキップされます。--max-input-side 0を指定すると無効化できます。
- 最長辺が
- ウォッチャー起動時の過去画像への遡及処理防止:
watch_upscale.pyは起動時に既存のComfyUI履歴/フォルダ内容のスナップショットを取得し、その後に生成された新しい画像のみを処理します。
確認
- オンデマンド実行の場合:コマンドが終了コード
0で終了し、[UPSCALED] <source> -> upscaled/...と表示されることを確認します。 - ウォッチャー実行の場合:
--once --dry-runテストを実行するか、デーモンログでWaiting for new images...を確認し、ComfyUIで1枚の画像を生成すると、再トリガーなしにちょうど1つの[Upscaled OK]エントリが生成されることを確認します。