ComfyUIワークフローテンプレート機能詳細ガイド

ワークフローテンプレートはComfyUIで非常に実用的な機能で、様々なプリセットワークフローを探索し使用するための便利な方法を提供します。これらのテンプレートは公式にサポートされているモデルワークフローとコミュニティ開発者が提供するサンプルワークフローをカバーしています。

ComfyUIのテンプレートシステムでは、以下のような内容を発見できます：

• 公式内蔵モデルワークフローテンプレート
• サードパーティカスタムノードが提供するサンプルワークフロー

テンプレート機能へのアクセス方法

ワークフローテンプレートを開くには、メニューバーでワークフロー —> ワークフローテンプレートを参照をクリックしてテンプレート参照インターフェースに入ります。

テンプレート使用ガイド

基本操作手順

1. テンプレート選択: テンプレートリストで使用したいテンプレートをクリックすると、システムが自動的に対応するワークフローを読み込みます
2. モデル確認: テンプレートを読み込む際、ComfyUIは必要なモデルファイルがインストールされているか自動的に確認します
3. 不足モデルダウンロード: 必要なモデルファイルが不足していることが判明した場合、システムがダウンロードを要求します
4. ワークフロー実行: すべての要素（モデル、入力画像、プロンプトなど）が準備できていることを確認した後、実行ボタンをクリックして使用を開始します

モデルファイル管理

各ワークフローテンプレートは対応するモデル情報を含んでいます。初回使用時にモデルファイルが不足していることが検出されると、システムがダウンロードプロンプトを表示します。

ダウンロード方法の説明:

• デスクトップ版ユーザー: ダウンロードボタンをクリックした後、プログラムが自動的にモデルファイルのダウンロードとインストールを完了します
• その他のバージョンユーザー: ブラウザを通じてモデルファイルをダウンロードし、手動でファイルを正しいディレクトリに配置します

モデル保存場所:

スクリーンショットのモデルを例として、ファイルを以下の場所に保存する必要があります：

📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── qwen_image_fp8_e4m3fn.safetensors
│   ├── 📂 vae/
│   │   └── qwen_image_vae.safetensors
│   └── 📂 text_encoders/
│       └── qwen_2.5_vl_7b_fp8_scaled.safetensors

重要な注意事項: 現在のバージョンのテンプレートシステムは、モデルファイルが対応する1次ディレクトリに存在するかどうかのみを検出できます。既にモデルファイルをサブフォルダに保存している場合（例：ComfyUI/models/diffusion_models/wan_video）、ダウンロードプロンプトを無視し、対応するモデル読み込みノードで正しいモデルファイルが選択されていることを確認するだけで十分です。

テンプレート技術実装原理

モデル情報埋め込みメカニズム

テンプレートシステムは、ノードのpropertiesにmodels情報を追加することでモデルリンクを埋め込みます。以下はモデル情報を含むDualCLIPLoaderノードの例です：

    {
      "id": 40,
      "type": "DualCLIPLoader",
      "pos": [
        -320,
        290
      ],
      "size": [
        270,
        130
      ],
      "flags": {},
      "order": 0,
      "mode": 0,
      "inputs": [],
      "outputs": [
        {
          "name": "CLIP",
          "type": "CLIP",
          "links": [
            64
          ]
        }
      ],
      "properties": {
        "Node name for S&R": "DualCLIPLoader",
        "cnr_id": "comfy-core",
        "ver": "0.3.40",
        "models": [
          {
            "name": "clip_l.safetensors",
            "url": "https://huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/clip_l.safetensors",
            "directory": "text_encoders"
          },
          {
            "name": "t5xxl_fp16.safetensors",
            "url": "https://huggingface.co/comfyanonymous/flux_text_encoders/resolve/main/t5xxl_fp16.safetensors",
            "directory": "text_encoders"
          }
        ]
      },
      "widgets_values": [
        "clip_l.safetensors",
        "t5xxl_fp16.safetensors",
        "flux",
        "default"
      ]
    }

モデル情報構造の説明

propertiesに新しく追加されたmodelsフィールドには以下の情報が含まれます：

• name: モデルファイルの名前
• url: モデルファイルの直接ダウンロードリンク（リポジトリアドレスではなく、直接ダウンロード可能なファイルリンクである必要があります）
• directory: ComfyUI/modelsディレクトリ下のモデルファイル保存場所

サポートされているモデルソース: 現在、システムはHugging FaceとCivitAIのモデルリンクをサポートしており、モデル形式が安全な形式（例：.safetensors、.sftなど）である必要があります。安全でない形式（例：.gguf）は埋め込み後に安全でない状態として表示され、ダウンロードリンクが表示されません。

編集ツール: このツールを使用してワークフローテンプレートのモデル情報を編集できますが、現在@ComfyUI-Wikiはネイティブノードのみにサポートを提供しています。

テンプレート更新メカニズム

依存関係管理

テンプレートシステムは独立した依存関係パッケージを通じて管理・更新され、対応するパッケージ名はcomfyui-workflow-templatesです。

ComfyUIを更新した後、新しいドキュメントや更新ノートで言及されたテンプレートが不足していることを発見した場合、関連する依存関係が同時に更新されていない可能性があります。ComfyUI/requirements.txtを確認して現在の依存関係バージョンを理解できます。

コア依存関係パッケージ: 以下の3つの依存関係は通常、各ComfyUI更新とともに同時にアップグレードされます：

comfyui-frontend-package==1.24.4
comfyui-workflow-templates==0.1.52
comfyui-embedded-docs==0.2.4

正しく更新する方法がわからない場合は、ComfyUIの更新章を参照して詳細な更新手順を確認してください。

コミュニティ貢献ガイドライン

公式テンプレート貢献

すべての公式テンプレートはworkflow_templatesリポジトリでホストされており、Pull Requestを送信してテンプレートに貢献できます。

公式テンプレート要件:

1. 純粋なネイティブサポート: 不足しているノードによりユーザーが追加インストールを必要としないよう、サードパーティノードを使用しない
2. 重複回避: テンプレートが既存のテンプレートと重複しないことを確認し、サポートされている関連モデル機能でなければならない
3. 問題フィードバック: 質問がある場合は、対応するリポジトリにissueを送信してディスカッションできます

カスタムノードテンプレート

カスタムノード開発者がテンプレートとサンプルワークフローを提供している場合、テンプレートブラウザーでも見つけることができます。通常、ノード名に対応するカテゴリを見つけるだけで、開発者が提供するすべてのテンプレートを確認できます。

開発者注意事項: 現在、システムはテンプレートフォルダ下の1次ディレクトリ構造のみをサポートし、マルチレベルディレクトリはサポートせず、JSON形式のテンプレートファイルのみをサポートしています。

カスタムノードテンプレート開発

カスタムノードにテンプレートサポートを追加したい場合は、カスタムノードテンプレート章を参照して詳細な開発プロセスを理解できます。また、カスタムノード開発者にPull Requestを送信してテンプレートコンテンツに貢献することもできます。