完全なComfy CLIユーザーガイド
Comfy CLIは、ComfyUIが提供する公式のコマンドラインツールです。ComfyUIのインストールプロセスを簡素化するだけでなく、強力な管理機能も提供します。このガイドでは、Comfy CLIのすべての機能を包括的にカバーします。
基本コマンド
インストールと設定
# comfy-cliをインストール
pip install comfy-cli
# コマンドライン自動補完を有効化
comfy --install-completion
# ComfyUIをインストール
comfy install
# ComfyUIを起動
comfy launchワークスペース管理
comfy-cliは複数のComfyUIワークスペースの管理をサポートし、異なるComfyUI環境を同時に維持できます：
基本的なワークスペース操作
# 現在のワークスペースパスを確認
comfy which
# デフォルトワークスペースを設定
comfy set-default /path/to/your/workspace
# 起動パラメータ付きでデフォルトワークスペースを設定
comfy set-default /path/to/your/workspace --launch-extras="--listen 0.0.0.0 --port 8080"異なるワークスペースでのコマンド実行
1. ワークスペースを指定：
# 指定されたワークスペースでComfyUIを起動
comfy --workspace=/path/to/workspace launch
# 指定されたワークスペースにノードをインストール
comfy --workspace=/path/to/workspace node install ComfyUI-Impact-Pack2. 最近のワークスペースを使用：
# 最近使用されたComfyUIを起動
comfy --recent launch
# 最近のワークスペースでノードを更新
comfy --recent node update all3. 現在のディレクトリで操作：
# 現在のディレクトリのComfyUIにノードをインストール
comfy --here node install ComfyUI-Impact-Pack
# 現在のディレクトリでComfyUIを起動
comfy --here launch
# 現在のディレクトリにComfyUIがあるかチェック
comfy --here whichワークスペースオプションの制限
重要な注意：
--workspace、--recent、--hereオプションは同時に使用できません。
ワークスペース優先度ルール
ワークスペースを明示的に指定しない場合、comfy-cliは以下の優先度に基づいて自動的に選択します：
comfy set-default <path>で指定されたデフォルトComfyUIパス- 最近実行または最近インストールされたComfyUI
- 現在のディレクトリのComfyUI
実用的な使用例
シナリオ1：異なるプロジェクト用の独立環境の作成
# プロジェクトA用のワークスペースを作成
comfy --workspace=~/projects/projectA install
# プロジェクトB用のワークスペースを作成
comfy --workspace=~/projects/projectB install
# プロジェクトAに特定のノードをインストール
comfy --workspace=~/projects/projectA node install ComfyUI-AnimateDiff-Evolved
# プロジェクトBに異なるノードをインストール
comfy --workspace=~/projects/projectB node install ComfyUI-Impact-Packシナリオ2：クイック環境切り替え
# 頻繁に使用するワークスペースをデフォルトに設定
comfy set-default ~/projects/main-workspace
# 一時的に他のワークスペースで作業
comfy --workspace=~/projects/test-workspace launch
# デフォルトワークスペースに戻る
comfy launch起動オプション
ComfyUIは異なる要件を満たすための豊富な起動オプションを提供します：
基本起動
# デフォルト起動
comfy launch
# バックグラウンドで実行
comfy launch --background
# バックグラウンドインスタンスを停止
comfy stopネットワーク設定
# リッスンアドレスとポートを指定
comfy launch -- --listen 0.0.0.0 --port 8080
# 外部アクセスを許可
comfy launch -- --listen 0.0.0.0パフォーマンス最適化
# CPUモードを使用
comfy launch -- --cpu
# 低VRAMモード
comfy launch -- --lowvram
# 超低VRAMモード
comfy launch -- --novram
# モデルCPUオフロードを有効化
comfy launch -- --cpu-vaeカスタムノード管理
ノード情報の表示
# 利用可能なすべてのノード情報を表示
comfy node show all
# インストール済みノードの簡単表示
comfy node simple-show installed
# 有効なノードを表示
comfy node show enabled
# 未インストールのノードを表示
comfy node show not-installed
# 無効なノードを表示
comfy node show disabled
# 特定チャンネルのノードを表示
comfy node show all --channel recentノードのインストールと更新
# カスタムノードをインストール
comfy node install ComfyUI-Impact-Pack
# すべてのノードを更新
comfy node update all
# 特定のノードを更新
comfy node update ComfyUI-Impact-Packノードスナップショット管理
スナップショット機能は、ノード設定状態の保存と復元に役立ちます：
# ノードスナップショットを保存
comfy node save-snapshot
# スナップショットリストを表示
comfy node show snapshot-list
# ノードスナップショットを復元
comfy node restore-snapshot <snapshot_name>依存関係管理
# ワークフローファイルから依存関係をインストール
comfy node install-deps --workflow=workflow.json
# ワークフローPNGファイルから依存関係をインストール
comfy node install-deps --workflow=workflow.png
# 依存関係JSONファイルからインストール
comfy node install-deps --deps=dependencies.json
# ワークフロー依存関係ファイルを生成
comfy node deps-in-workflow --workflow=workflow.json --output=deps.jsonノードトラブルシューティング（Bisect）
ノードの競合や問題に遭遇した場合、bisect機能を使用して問題のあるノードを迅速に特定します：
# トラブルシューティングセッションを開始
comfy node bisect start
# 現在の状態を良好としてマーク
comfy node bisect good
# 現在の状態を問題ありとしてマーク
comfy node bisect bad
# トラブルシューティングセッションをリセット
comfy node bisect resetモデル管理
モデルダウンロード
# URLからモデルをダウンロード（CivitAI、Hugging Faceなどをサポート）
comfy model download --url https://huggingface.co/model/url
# 指定された相対パスにダウンロード
comfy model download --url https://civitai.com/api/download/models/123456 --relative-path models/checkpoints
# CivitAI APIトークンを設定（ログイン必須モデルのダウンロード用）
comfy model download --url https://civitai.com/api/download/models/123456 --set-civitai-api-token YOUR_TOKEN
# 複数オプションを組み合わせ
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpointsモデル管理
# デフォルトパスのすべてのモデルをリスト
comfy model list
# 指定パスのモデルをリスト
comfy model list --relative-path models/loras
# 指定されたモデルを削除
comfy model remove --model-names "model1.safetensors,model2.ckpt"
# 指定パスからモデルを削除
comfy model remove --relative-path models/checkpoints --model-names "old_model.ckpt"サポートされているモデルソース
- Hugging Face：直接ファイルURLを使用
- CivitAI：モデルダウンロードAPI URLを使用
- その他の直接リンク：直接ダウンロード可能なモデルファイルURL
ComfyUI-Manager管理
comfy-cliはComfyUI-Managerの設定も管理できます：
# ComfyUI-Manager GUI（メニューとサーバー）を無効化
comfy manager disable-gui
# ComfyUI-Manager GUIを有効化
comfy manager enable-gui
# 予約された起動アクションをクリア
comfy manager clear環境情報
現在のComfyUI環境に関する詳細情報を表示：
# 実行状態、ワークスペースなどを含む環境情報を表示
comfy env
# トラッキング設定状態をチェック
comfy tracking status
# 使用状況トラッキングを無効化
comfy tracking disable
# 使用状況トラッキングを有効化
comfy tracking enable高度な機能
ベータ機能：comfy-lock.yaml
comfy-cliはcomfy-lock.yamlファイルを使用したプロジェクト依存関係管理をサポートします：
basic:
models:
- model: [モデル名]
url: [モデルソースURL、例：https://huggingface.co/...]
paths: [モデルパスリスト]
- path: [モデルパス]
- path: [モデルパス]
hashes: [モデルハッシュ]
- hash: [ハッシュ値]
type: [AutoV1, AutoV2, SHA256, CRC32, Blake3]
type: [モデルタイプ、例：diffuser, lora, etc.]
# ComfyUI-Manager .yamlスナップショットと互換
custom_nodes:
comfyui: [コミットハッシュ]
file_custom_nodes:
- disabled: [bool]
filename: [.pyファイル名]
...
git_custom_nodes:
[git-url]:
disabled: [bool]
hash: [コミットハッシュ]
...一般的な使用シナリオ
開発環境管理
# 開発環境を作成
comfy --workspace=~/dev/comfyui-dev install
# テスト環境を作成
comfy --workspace=~/test/comfyui-test install
# 開発環境に実験的ノードをインストール
comfy --workspace=~/dev/comfyui-dev node install experimental-node
# テスト環境に素早く切り替えてテスト
comfy --workspace=~/test/comfyui-test launchプロジェクト依存関係管理
# プロジェクト用の依存関係スナップショットを作成
comfy node save-snapshot project-v1.0
# プロジェクトワークフロー依存関係をインストール
comfy node install-deps --workflow=project-workflow.json
# 特定バージョンの依存関係に復元
comfy node restore-snapshot project-v1.0自動化されたモデル管理
# プロジェクトに必要なモデルをバッチダウンロード
comfy model download --url https://huggingface.co/model1 --relative-path models/checkpoints
comfy model download --url https://huggingface.co/model2 --relative-path models/loras
# 古いモデルをクリーンアップ
comfy model remove --model-names "old_model1.ckpt,old_model2.safetensors"トラブルシューティング
一般的な問題
-
ワークスペースパスの問題
# 現在のワークスペースをチェック comfy which # パスが間違っている場合、リセット comfy set-default /correct/path -
ノード競合の問題
# bisect機能を使用して問題を特定 comfy node bisect start # プロンプトに従って正常/異常状態をマーク -
権限の問題
# 十分な権限があることを確認 ls -la ~/comfy