メインコンテンツへスキップ
python main.py で ComfyUI を起動する際、コマンドライン引数を指定できます。このページでは comfy/cli_args.py で定義されているすべてのフラグを説明します。
Windows ポータブル版 ユーザーは .bat 起動ファイル（例：run_nvidia_gpu.bat）にフラグを追加できます。詳細は Windows ポータブル版インストールガイド を参照してください。
ComfyUI ディレクトリで python main.py --help を実行すると、組み込みヘルプを確認できます。必要に応じて複数のフラグを組み合わせてください： 
python main.py --listen 0.0.0.0 --port 8288 --disable-auto-launch --lowvram

​
ネットワークとサーバー

フラグデフォルト説明
--listen [IP]127.0.0.1待ち受ける IP アドレス。カンマ区切りで複数指定可能（例：127.2.2.2,127.3.3.3）。値なしの場合は 0.0.0.0,::（すべての IPv4/IPv6 インターフェース）。
--port8188待ち受けポート。
--tls-keyfile PATH—TLS（SSL）キーファイルのパス。HTTPS を有効化。--tls-certfile が必要。
--tls-certfile PATH—TLS（SSL）証明書ファイルのパス。HTTPS を有効化。--tls-keyfile が必要。
--enable-cors-header [ORIGIN]無効CORS を有効化。オプションでオリジン指定。値なしの場合は *（すべてのオリジン）。
--max-upload-size100最大アップロードサイズ（MB）。
--enable-compress-response-body無効HTTP レスポンスボディの圧縮を有効化。
# すべてのインターフェースで待受（LAN アクセス）
python main.py --listen

# 特定の IP で待受
python main.py --listen 0.0.0.0

# カスタムポートと HTTPS
python main.py --port 8443 --tls-keyfile key.pem --tls-certfile cert.pem

​
ディレクトリ

フラグデフォルト説明
--base-directory PATHComfyUI ルートmodels、custom_nodes、input、output、temp、user などのベースディレクトリ。
--extra-model-paths-config PATH—1 つ以上の extra_model_paths.yaml を読み込み。複数回指定可能。
--output-directory PATH—出力ディレクトリ。--base-directory を上書き。
--temp-directory PATH—一時ディレクトリ。--base-directory を上書き。
--input-directory PATH—入力ディレクトリ。--base-directory を上書き。
--user-directory PATH—ユーザーディレクトリ（絶対パス）。--base-directory を上書き。パスは存在し読み取り可能である必要あり。

​
起動とブラウザ

フラグデフォルト説明
--auto-launch無効起動時にデフォルトブラウザで ComfyUI を自動的に開く。
--disable-auto-launch無効ブラウザの自動起動を無効化。
--windows-standalone-build無効Windows ポータブル版の便利モード。起動時にブラウザを自動で開く（--auto-launch と同等）。
--windows-standalone-build は auto_launch を true に設定します。--disable-auto-launch で上書きできます。ブラウザを開かずにサーバーとして実行するには --disable-auto-launch を使用してください。
# ブラウザを開かずにサーバーを実行
python main.py --disable-auto-launch

​
デバイスと CUDA

フラグデフォルト説明
--cuda-device DEVICE_ID—使用する CUDA デバイス ID（カンマ区切り、例：0 または 0,1）。他のデバイスは非表示。
--default-device ID—デフォルトデバイス ID。他のデバイスは表示されたまま。
--cuda-malloc自動（torch 2.0+）cudaMallocAsync を有効化。--disable-cuda-malloc と排他。
--disable-cuda-malloc—cudaMallocAsync を無効化。--cuda-malloc と排他。
--directml [DEVICE]—torch-directml を使用。オプションのデバイスインデックス。値なしの場合は -1。
--oneapi-device-selector STRING—Intel デバイス用 oneAPI デバイスセレクター文字列。

​
精度と推論

以下の グローバル、UNET、VAE、テキストエンコーダー 各グループ内のフラグは排他的です。各グループで同時に 1 つだけ使用できます。

​
グローバル浮動小数点

フラグ説明
--force-fp32グローバルに fp32 を強制。GPU 性能が向上する場合は報告してください。
--force-fp16グローバルに fp16 を強制。--fp16-unet も設定。

​
UNET 精度

フラグ説明
--fp32-unet拡散モデルを fp32 で実行。
--fp64-unet拡散モデルを fp64 で実行。
--bf16-unet拡散モデルを bf16 で実行。
--fp16-unet拡散モデルを fp16 で実行。
--fp8_e4m3fn-unetUNet 重みを fp8（e4m3fn）で保存。
--fp8_e5m2-unetUNet 重みを fp8（e5m2）で保存。
--fp8_e8m0fnu-unetUNet 重みを fp8（e8m0fnu）で保存。

​
VAE 精度

フラグ説明
--fp16-vaeVAE を fp16 で実行。黒い画像になる可能性あり。
--fp32-vaeVAE を fp32 全精度で実行。
--bf16-vaeVAE を bf16 で実行。
--cpu-vaeVAE を CPU で実行（VAE 精度フラグとは排他ではない）。

​
テキストエンコーダー精度

フラグ説明
--fp8_e4m3fn-text-encテキストエンコーダー重みを fp8（e4m3fn）で保存。
--fp8_e5m2-text-encテキストエンコーダー重みを fp8（e5m2）で保存。
--fp16-text-encテキストエンコーダー重みを fp16 で保存。
--fp32-text-encテキストエンコーダー重みを fp32 で保存。
--bf16-text-encテキストエンコーダー重みを bf16 で保存。

​
その他の推論オプション

フラグデフォルト説明
--fp16-intermediates無効実験的：ノード間の中間テンソルに fp32 の代わりに fp16 を使用。
--force-channels-last無効推論時に channels-last メモリ形式を強制。
--supports-fp8-compute無効デバイスが fp8 計算をサポートしているかのように動作。
--enable-triton-backend無効comfy-kitchen で Triton バックエンドを有効化。起動時はデフォルトで無効。

​
プレビュー

フラグデフォルト説明
--preview-methodnoneサンプラーノードのプレビュー方式。選択肢：none、auto、latent2rgb、taesd。
--preview-size512プレビュー画像の最大サイズ（ピクセル）。

​
キャッシュ

キャッシュモードのフラグは排他的です。--cache-ram、--cache-classic、--cache-lru、--cache-none のいずれか 1 つのみ使用してください。
フラグデフォルト説明
--cache-ram [GB] [GB]有効（デフォルト）RAM 圧力キャッシュ。第 1 値：アクティブキャッシュ閾値（GB）。第 2 値（任意）：非アクティブ/ピン閾値（GB）。値なしの場合：アクティブ = システム RAM の 10%（最小 2 GB、最大 10 GB）；非アクティブ = システム RAM の 100%（最大 96 GB）。最大 2 値。
--cache-classic—旧式の積極的キャッシュを使用。
--cache-lru N0（無効）LRU キャッシュ。最大 N 個のノード結果をキャッシュ。RAM/VRAM を多く使用する可能性あり。
--cache-none—RAM/VRAM 使用量を削減。実行のたびにすべてのノードを再実行。

​
アテンション

クロスアテンション方式のフラグは排他的です。xformers 使用時、split と quad アテンションは無視されます。
フラグ説明
--use-split-cross-attentionsplit クロスアテンション最適化を使用。
--use-quad-cross-attentionsub-quadratic クロスアテンション最適化を使用。
--use-pytorch-cross-attentionPyTorch 2.0 クロスアテンションを使用。
--use-sage-attentionSage アテンションを使用。
--use-flash-attentionFlashAttention を使用。
--disable-xformersxformers を無効化。
--force-upcast-attentionアテンションのアップキャストを強制。黒い画像が修正される場合は報告してください。--dont-upcast-attention と排他。
--dont-upcast-attentionすべてのアテンションアップキャストを無効化。デバッグ用。

​
VRAM とメモリ

VRAM モードのフラグ（--gpu-only、--highvram、--lowvram、--novram、--cpu）は排他的です。
フラグデフォルト説明
--gpu-only—すべて（テキストエンコーダー、CLIP など）を GPU に保存して実行。
--highvram—使用後もモデルを CPU にアンロードせず GPU メモリに保持。
--lowvram—動的 VRAM 有効時は効果なし。それ以外ではテキストエンコーダーを CPU で実行。
--novram—--lowvram でも不足する場合の最小 VRAM 使用。
--cpu—すべて CPU で実行（遅い）。
--reserve-vram GBOS 依存OS と他ソフトウェア用に予約する VRAM（GB）。
--async-offload [NUM_STREAMS]Nvidia でデフォルト有効非同期ウェイトオフロード。オプションのストリーム数（デフォルト：2）。
--disable-async-offload—非同期ウェイトオフロードを無効化。
--disable-dynamic-vram—動的 VRAM を無効化。推定ベースのモデル読み込みを使用。
--enable-dynamic-vramNvidia で自動デフォルトで無効なシステムで動的 VRAM を有効化。
--fast-disk無効非ピン RAM よりディスクベースの動的読み込みを優先。高速 NVMe に有用。
--force-non-blocking無効非ブロッキングテンソル操作を強制。非 Nvidia システムで改善する可能性。一部ワークフローで問題の可能性。
--disable-smart-memory無効VRAM に保持せず RAM へ積極的にオフロード。
--disable-pinned-memory無効ピン留めメモリの使用を無効化。
--mmap-torch-files無効ckpt/pt ファイル読み込み時に mmap を使用。
--disable-mmap無効safetensors 読み込み時に mmap を使用しない。

​
パフォーマンスとデバッグ

フラグデフォルト説明
--fast [OPT...]無効品質や安定性に影響する可能性のある実験的最適化を有効化。--fast のみですべて有効。オプション：fp16_accumulation、fp8_matrix_mult、cublas_ops、autotune。
--deterministic無効可能な限り遅い決定論的 PyTorch アルゴリズムを使用。すべての場合で同一画像を保証しない。
--default-hashing-functionsha256重複ファイル名/内容比較用ハッシュ関数。選択肢：md5、sha1、sha256、sha512。
# すべての fast 最適化を有効化（実験的）
python main.py --fast

# 特定の最適化のみ有効化
python main.py --fast fp16_accumulation cublas_ops

​
ComfyUI Manager

セットアップ手順は ComfyUI-Manager インストール を参照。
フラグ説明
--enable-managerComfyUI-Manager を有効化。
--disable-manager-uiManager UI とエンドポイントのみ無効化。バックグラウンドタスク（スケジュールインストールなど）は継続。--enable-manager が必要。
--enable-manager-legacy-uiレガシー Manager UI を使用。--enable-manager が必要。

​
カスタムノードと API ノード

フラグデフォルト説明
--disable-all-custom-nodes無効すべてのカスタムノードの読み込みを無効化。
--whitelist-custom-nodes FOLDER...—--disable-all-custom-nodes 有効時も読み込むカスタムノードフォルダ。
--disable-api-nodes無効API ノードを無効化し、フロントエンドのインターネット通信を防止。
--disable-metadata無効出力ファイルへのプロンプトメタデータ保存を無効化。
# カスタムノードの問題をトラブルシュート
python main.py --disable-all-custom-nodes

# 特定のカスタムノードのみ許可
python main.py --disable-all-custom-nodes --whitelist-custom-nodes ComfyUI-Manager

​
フロントエンドと API

フラグデフォルト説明
--front-end-versioncomfyanonymous/ComfyUI@latestフロントエンドバージョン。[owner]/[repo]@[version] 形式。GitHub releases からのダウンロードにインターネット接続が必要。バージョンは latest または semver（例：1.0.0）。
--front-end-root PATH—フロントエンドディレクトリのローカルパス。--front-end-version を上書き。
--comfy-api-basehttps://api.comfy.orgComfyUI API のベース URL。
--database-urlsqlite:///<ComfyUI>/user/comfyui.dbデータベース URL。メモリ DB は sqlite:///:memory:。
--enable-assets無効アセットシステムを有効化（API ルート、DB 同期、バックグラウンドスキャン）。
--feature-flag KEY[=VALUE]—サーバー機能フラグを設定。KEY のみで true。複数回指定可能。ブール値と数値は自動変換。
--list-feature-flags—既知の CLI 機能フラグを JSON で出力して終了。
# 利用可能な機能フラグを一覧表示
python main.py --list-feature-flags

# 機能フラグを設定
python main.py --feature-flag show_signin_button=true

​
ログとその他

フラグデフォルト説明
--verbose [LEVEL]INFOログレベル。選択肢：DEBUG、INFO、WARNING、ERROR、CRITICAL。--verbose のみで DEBUG。
--log-stdout無効通常のプロセス出力を stderr ではなく stdout に送信。
--dont-print-server無効コンソールにサーバー出力を表示しない。
--multi-user無効ユーザーごとのストレージを有効化。
--quick-test-for-ci無効CI 用クイック起動テスト。初期化後すぐに終了。
このリファレンスは ComfyUI の comfy/cli_args.py に基づいています。ComfyUI をアップグレードした際は、python main.py --help を実行するか、ローカルの cli_args.py とこのページを照合して、新規または変更されたフラグがないか確認してください。