Community画像github.com

comfyui-auto-upscale

ComfyUIが生成した画像を自動的にアップスケールします。HTTP/WebSocket API経由で動作し、最新画像のオンデマンドアップスケール、フォルダのバッチアップスケール、バックグラウンド監視による自動アップスケールをサポートします。

comfyui-auto-upscale とは?

ComfyUI Auto-Upscaleは、ComfyUIのHTTP/WebSocket APIを通じて生成画像を自動的に高解像度化するスキルです。主に3つのモードを提供します。(1)オンデマンドモードでは、最新生成画像や指定フォルダ内の画像を即座にアップスケールできます。(2)ウォッチャーモードでは、ComfyUIが画像を生成するたびに自動的にアップスケールを実行するデーモンをバックグラウンドで起動します。(3)カスタムワークフローモードでは、Ultimate SD UpscaleやTiled Diffusion、SUPIRなどの独自のComfyUIワークフローを使用可能です。標準ライブラリのみで実装されており、無限ループ防止機構や解像度制限ガード、OOM防止機能などのセーフティ機能を内蔵しています。4x-UltraSharpやRealESRGANなどの内蔵モデルに対応し、設定ファイルによる再利用可能な構成もサポートしています。開発者にとっては、Pythonスクリプトの直接実行とCLI引数による柔軟な制御が可能で、CI/CDパイプラインへの組み込みにも適しています。

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

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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 を参照してください。

ビルトインセーフティガード

  1. 無限ループ防止:
    • 送信されたすべてのアップスケールジョブは extra_data.auto_upscale_generated = true でタグ付けされ、prompt_id で追跡されます。
    • 出力は upscaled/ に保存され(デフォルトで filename_prefix = "upscaled/upscaled")、両方のスクリプトは upscaled/ 内の画像や upscaled_ プレフィックスに一致する画像を自動的に無視します。
  2. OOM / 過剰アップスケール防止:
    • 最長辺が --max-input-side(デフォルト 2048 px)を超える画像は自動的にスキップされます。--max-input-side 0 を指定すると無効化できます。
  3. ウォッチャー起動時の過去画像への遡及処理防止:
    • watch_upscale.py は起動時に既存のComfyUI履歴/フォルダ内容のスナップショットを取得し、その後に生成された新しい画像のみを処理します。

確認

  • オンデマンド実行の場合:コマンドが終了コード 0 で終了し、[UPSCALED] <source> -> upscaled/... と表示されることを確認します。
  • ウォッチャー実行の場合:--once --dry-run テストを実行するか、デーモンログで Waiting for new images... を確認し、ComfyUIで1枚の画像を生成すると、再トリガーなしにちょうど1つの [Upscaled OK] エントリが生成されることを確認します。

関連スキル