> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# パフォーマンステストとベンチマーク

> Comfy Desktop のパフォーマンステストで ComfyUI ワークフローの速度を測定し、ベンチマークで GPU、ワークフロー、インスタンスごとに実行結果を比較できます

**Performance Tests** は、ComfyUI ワークフローがお使いのインスタンスの 1 つで実行されるのにかかる時間を測定します。インスタンスを選択し、ワークフローを読み込むと、Comfy Desktop がそれを指定した実行回数だけ実行し、測定対象の各実行を計測して、最速、最遅、平均、中央値の所要時間を、その数値の基になったハードウェアとソフトウェアとともに報告します。

**Benchmarks** は、記録されたこれらの結果を比較します。保存されたすべての実行を一覧表示し、ワークスペース、インスタンス、ハードウェア、またはワークフローでフィルタリングし、選択済みの実行を相対速度係数とともに並べて表示するので、ある GPU、ワークフロー、インスタンスが別のものよりどれだけ速いかを確認できます。

どちらのパネルもアプリメニューから開きます。左上隅の ☰ メニューをクリックし、**Performance Tests** または **Benchmarks** を選択します。

![ハンバーガーメニューを開いた Dashboard：(1) タイトルバーの ☰ ボタン、(2) Performance Tests 項目](https://mintcdn.com/dripart/N4LZwJLSpBN0lv19/images/desktop/usage/performance_tests_menu_entry.png?fit=max\&auto=format\&n=N4LZwJLSpBN0lv19\&q=85\&s=8531a565e714af79c9bbf0156c2727b1)

> [!NOTE]
>
> Performance Tests は実際のインスタンスで実際のワークフローを実行するため、テストにかかる時間は、ワークフロー自体の時間に実行回数を掛けた程度になります。インポートするワークフローは、事前に [API 形式](https://docs.comfy.org/ja/development/api-development/workflow-api-format.md) でエクスポートしておく必要があります。Comfy Desktop に同梱のサンプルワークフローは、すでにこの形式です。

## パフォーマンステストの実行

パネルは3つの番号付きステップが横並びで構成されています。ウィンドウが狭いときは縦に積み重なります。

![Performance Tests パネル: インスタンスの選択、ワークフローの選択、ウォームアップ実行と測定実行の設定](https://mintcdn.com/dripart/N4LZwJLSpBN0lv19/images/desktop/usage/performance_tests_01_panel.png?fit=max\&auto=format\&n=N4LZwJLSpBN0lv19\&q=85\&s=86577c5f2c65e0c69a970ef991cb4a67)

### 1. インスタンスを選択

テストする**ワークスペース**と**インスタンス**を選択します。インスタンス一覧はワークスペースで絞り込まれるため、チームに属するインスタンスを使うにはワークスペースを切り替えてください。インスタンスとそのハードウェアは結果とともに記録されます。これが後での比較を意味あるものにします。異なるGPUでの実行は区別できるままです。

テストを開始すると、Comfy Desktop はそのインスタンスの前回のパフォーマンステストセッションがまだ実行中であれば停止し、そのインスタンスをコンソールセッションで起動します。他のローカル ComfyUI が実行中、起動中、または停止中である間はテストの開始を拒否し、妨げになっているインスタンスの名前を表示します。それらを停止するか、起動または停止が完了するのを待ってから、もう一度テストを実行してください。Comfy Cloud やリモートのインスタンスは別の場所で実行されるため、テストを妨げません。ゲームや動画の書き出しなど、GPU を占有する他の作業は測定値に影響するため、テストを実行する前に停止してください。

### 2. ワークフローを選択

Comfy Desktop に同梱されているサンプルワークフローを選ぶことも、自分のワークフローを持ち込むこともできます。

**Choose an example workflow** をクリックするとピッカーが開きます。サンプルは **Video**、**Image**、**Audio** のタブに分類され、各カードには名前、タスク、モデルのダウンロードサイズが表示されます。カードのモデルがすでにディスク上にある場合、そのサイズの代わりにハードディスクのアイコンが表示され、カーソルを合わせると **Downloaded** とモデルのサイズ（例: **Downloaded · \~17 GB**）が表示されます。これらのモデルは再ダウンロードされず、空き容量の計算にも含まれません。

![サンプルワークフローのピッカー: モダリティ別のタブ、各カードのダウンロードサイズ、モデルがすでにディスク上にあるカードの Downloaded ツールチップ](https://mintcdn.com/dripart/d_0DKAqcN_K-jD-5/images/desktop/usage/performance_tests_02_example_workflows.png?fit=max\&auto=format\&n=d_0DKAqcN_K-jD-5\&q=85\&s=da325acaa82859119b655d3b6ac496b2)

カードを選択して **Use workflow** をクリックします。Comfy Desktop は API フォーマットのプロンプトを取得し、不足しているモデルをバックグラウンドでダウンロードします。ドロップゾーンに進行状況が表示され、ダウンロードが完了するまで **Run** は無効のままです。ゴミ箱ボタンのツールチップは **Cancel download** に切り替わります。ダウンロードに失敗すると、そのワークフローは削除されます。

![サンプルのダウンロード中のドロップゾーン: 進行状況バー、ゴミ箱ボタン、無効になっている Run](https://mintcdn.com/dripart/d_0DKAqcN_K-jD-5/images/desktop/usage/performance_tests_03_example_download.png?fit=max\&auto=format\&n=d_0DKAqcN_K-jD-5\&q=85\&s=b965a0ba98c303a3256734560f54d5a1)

ピッカーを使うには、インストール済みのインスタンスと正常な接続が必要で、どちらかが欠けている場合はドロップゾーンの下にその旨が表示されます。モデルが空きディスク容量に収まらない場合は、カードの上に警告が表示され、**Use workflow** は無効のままです。

![カードの上にディスクの警告が表示され、Use workflow が無効になっているサンプルワークフローのピッカー](https://mintcdn.com/dripart/d_0DKAqcN_K-jD-5/images/desktop/usage/performance_tests_04_disk_warning.png?fit=max\&auto=format\&n=d_0DKAqcN_K-jD-5\&q=85\&s=3c6fd6818a7199b56b5a4435eab05bc7)

サンプルはインスタンスに紐づきます。インスタンスを切り替えると、すでにテストで使用された場合を除いて、準備したサンプルは破棄されます。同梱のセットはリリースごとに変わります。

**自分のワークフロー**は [API フォーマット](https://docs.comfy.org/ja/development/api-development/workflow-api-format.md) でエクスポートする必要があります。`.json` ファイルをドロップゾーンにドロップするか、ゾーンをクリックしてファイルを参照します。

どちらの場合も、Comfy Desktop はワークフローをテストセッションフォルダーにコピーするため、オリジナルのファイルを移動したり編集した後でもテストは実行されます。

### 3. 測定設定を行う

| 設定 | 範囲 | デフォルト | 内容 |
| - | - | - | - |
| **ウォームアップ実行** | 0〜5 | 1 | 最初に実行され、モデルをロードしてキャッシュをウォームアップする実行。結果には含まれません。0 にするとウォームアップを省略します。 |
| **測定実行** | 1〜100 | 5 | ウォームアップ実行の後に計測される実行。その所要時間が結果の計算に使用されます。 |

各実行はワークフローの数値シード入力を1ずつ進めるため、測定実行で同一のキャッシュ結果が繰り返されることはありません。

3つのステップを設定したら、**Run** をクリックしてテストを開始します。隣の **Stop** ボタンで進行中のテストを中止できます。

### 結果を確認する

テストの実行中、パネルには完了した実行数とインスタンスのログが表示されます。すべての実行が完了すると、インスタンスは停止し、結果が表示されます:

* **最速実行**、**最遅実行**、**平均実行**、**中央値実行**（秒単位）
* **測定実行**と**失敗実行**: 所要時間が得られた実行数と、得られなかった実行数
* **実行所要時間の集計**: 4つの集計値（最速、最遅、平均、中央値）を比較する棒グラフ
* **システム情報**: コンピュートデバイス、VRAM、RAM、PyTorchバージョン、xFormersバージョン、CPU、CPUコア数、オペレーティングシステム、アーキテクチャ

実行の所要時間とは、ComfyUI がサーバー上でジョブを実行するのに費やした時間であり、あなたが待った時間ではありません。失敗した実行は別途カウントされ、統計からは除外されます。

結果とともに2つのボタンが表示されます。**フォルダーを開く**はセッションフォルダーを開き、**結果をエクスポート**はサマリーとチャートをPNG画像として保存します。

## ベンチマークで実行結果を比較する

ベンチマークはパフォーマンステストが保存した結果を読み込むため、少なくとも1つのテストが完了するまで表示する内容はありません。

### 実行ライブラリ

**実行ライブラリ**には、結果フォルダーに保存されたすべての実行が新しい順に一覧表示されます。ツールバーには次のものがあります：

* **フォルダーを選択**：パネルの参照先を別の結果フォルダー（たとえば共有ドライブ上のフォルダー）に変更します。既定では、パフォーマンステストが書き込むフォルダーです。詳しくは[結果の保存場所](#結果の保存場所)を参照してください。
* **セッションを更新**：別の場所でテストが完了した後にフォルダーを再読み込みします。
* **実行を検索**：テキストで一覧を絞り込みます。
* ワークスペース、インスタンス、ハードウェア、ワークフローで絞り込むドロップダウンフィルター。
* **プロパティ**：ライブラリに表示する列（セッション、日付と時間、ワークフロー、インスタンス、ワークスペース、実行回数、GPUとハードウェア）を選択します。

![フィルターと保存された実行の一覧表を備えた Benchmarks の実行ライブラリ](https://mintcdn.com/dripart/N4LZwJLSpBN0lv19/images/desktop/usage/benchmarks_01_runs_library.png?fit=max\&auto=format\&n=N4LZwJLSpBN0lv19\&q=85\&s=1e3539bb3b2f4ff6dd5dafc5da43b37d)

### 実行を比較する

チェックボックスで2つ以上の実行を選択するか、**表示中のすべての実行を選択**を使用します。ライブラリの読み込み時には、最新の3つの実行が自動的に選択されます。選択すると、ライブラリの下に**比較**セクションが開きます。

比較では、選択した実行ごとに1つの列が、メトリクスの行と並べて表示されます。行には最速、平均、中央値、最も遅い所要時間、および測定された実行回数があります。1つの実行が**ベースライン**になります。既定では、最初に表示される列がベースラインです。**速度**ビューで列見出しをクリックすると、代わりにその実行をベースラインにできます。

### 相対速度

比較には**所要時間**と**速度**の 2 つのビューがあり、比較ツールバーで切り替えます。相対速度は**速度**ビューに属し、ベースラインもこのビューで選択します。

**相対速度**は、ベースラインの所要時間をその実行の所要時間で割った値です：

* **1.00×** は、その実行がベースラインと同じ速度であることを意味します
* 1.00× より大きい係数は、その実行がベースラインより**高速**であることを意味します
* 1.00× より小さい係数は、その実行がベースラインより**低速**であることを意味します

**速度**ビューは各実行を対数軸上にプロットし、左に**低速**、右に**高速**が来るようにするため、2xと4xの差も同じチャート上で読み取れます。**所要時間**ビューでは、各実行の最速と最も遅い結果が線として描画され、平均がマークされます。有効な所要時間がない実行は利用不可と表示されます。

![1つの実行をベースライン、別の実行をより低速として示す Benchmarks の相対速度ビュー](https://mintcdn.com/dripart/N4LZwJLSpBN0lv19/images/desktop/usage/benchmarks_02_relative_speed.png?fit=max\&auto=format\&n=N4LZwJLSpBN0lv19\&q=85\&s=f7a10359d8f315548b8fe16a5513327b)

### 並び替えとエクスポート

* **比較を並び替え**は、選択した指標（最速・平均・中央値・最も遅い）で列を並べます。**手動並び替え**では、列をドラッグして任意の順序にできます。または、フォーカスした列で Alt+Left / Alt+Right を押します。
* **結果をエクスポート**は、比較全体をPNG画像として保存します。結果をIssueやチャットメッセージに添付する最短の方法です。選択した実行が20件を超える場合はエクスポートできません。

### セッションの管理

各テストはセッションとして保存されます。ライブラリから、セッションの名前を変更したり（**セッションを編集**）、削除したり（**削除**）できます。削除すると、そのセッションに記録されたすべてのファイルが削除されます。

## 結果の保存場所

Performance Tests は、ワークフローをパネルに追加したときにセッションフォルダーを作成し、その時点のタイムスタンプ（`YYYYMMDDHHMMSS`）を名前として付けます。

```
📂 ComfyUI-Shared/
└── 📂 benchmarks/
    ├── 📂 20260930141522/
    │   ├── my_workflow.json
    │   ├── jobs.json
    │   ├── results.json
    │   └── logs.txt
    └── 📂 20260930163005/
        └── ...
```

| プラットフォーム | デフォルトの結果フォルダー |
| - | - |
| Windows | `%LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Shared\benchmarks` |
| macOS / Linux | `~/ComfyUI-Shared/benchmarks` |

各セッションフォルダーには次のものが含まれます。

* パネルが使用したワークフローファイル
* `jobs.json`: インスタンスから返された生のジョブ応答
* `results.json`: Benchmarks パネルが読み取るサマリー
* `logs.txt`: 実行時のインスタンスのコンソール出力

Benchmarks は見つけたすべてのセッションフォルダーから `results.json` を読み取るため、セッションフォルダーを Benchmarks が参照するフォルダーにコピーするだけで、別のマシンの結果と比較できます。

同じインポート済みワークフローをもう一度実行すると、結果は同じセッションフォルダーに書き込まれ、そこに保存されている結果が上書きされます。比較用に結果を残したい場合は、次のテストの前にワークフローをもう一度パネルに追加してください。

## 要件

* Comfy Desktop が起動できるスタンドアロン、追跡対象、またはリモートのインスタンス。テストには動作する ComfyUI インスタンスが必要なため、クラウドインスタンスに対して実行することはできません。
* インスタンスが実行できるワークフロー。必要なモデルやカスタムノードも含みます。インポートするワークフローは API 形式である必要があります。サンプルワークフローはすでにその形式で、Comfy Desktop がモデルをダウンロードします。インスタンスがワークフローを拒否した場合、テストは停止し、エラーはログに表示されます。インスタンスが受け付けたものの実行中に失敗した実行は、失敗実行としてカウントされ、所要時間の統計から除外されます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.