Comfy CLI トラブルシューティングガイド

Comfy CLI のほとんどの問題は、前提条件の不足かセットアップ手順の抜けが原因です。問題を報告する前に、以下を順に確認してください。

前提条件

Comfy CLI を使用するには、システムに git がインストールされている必要があります。先に git をインストールすると、comfy install と comfy update が ComfyUI とカスタムノードをクローンできます。

comfy install は有効な Python 環境に ComfyUI をインストールします。Python 3.10 以降が必要です。先に仮想環境を作成して有効化してください：

python3 -m venv comfy-env
source comfy-env/bin/activate
comfy install

comfy install は使用する GPU を尋ね、それに合った PyTorch ビルドをインストールします。プロンプトに答えるか、フラグで GPU を指定して無人で実行してください：

プラットフォーム	`comfy install` がインストールするもの	別途必要なもの
NVIDIA	CUDA runtime 付き PyTorch（pip ホイール）	最新の GPU ドライバ（フルの CUDA Toolkit は不要）
AMD Linux	ROCm PyTorch ホイール	それらのホイールに対応する ROCm 対応 AMD ドライバ／スタック
AMD Windows	`torch-directml`	互換 AMD GPU（DirectML。ROCm ではない）
Apple silicon	PyTorch nightly ホイール（CPU インデックス；Metal/MPS）	Apple silicon 上の macOS
Intel Arc	PyTorch XPU ホイール	互換 Intel Arc GPU / XPU スタック
CPU	CPU 向け PyTorch ホイール	独立 GPU は不要

comfy install --nvidia

PyTorch を自分でインストールする場合は --skip-torch-or-directml を指定してください。comfy env は ComfyUI が使用する Python 環境とワークスペースを表示します。

comfy setup はブラウザ経由でサインインするため、CI、devcontainer、ヘッドレスサーバーでは完了できません。代わりに API キーを渡し、非対話モードで実行してください：

comfy setup --where cloud --api-key comfyui-... --non-interactive