完全な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-Pack
2. 最近のワークスペースを使用:
# 最近使用されたComfyUIを起動
comfy --recent launch
# 最近のワークスペースでノードを更新
comfy --recent node update all
3. 現在のディレクトリで操作:
# 現在のディレクトリの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