Skip to content
より良い ComfyUI ナレッジベースの構築を支援する サポーターになる

完全な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は以下の優先度に基づいて自動的に選択します:

  1. comfy set-default <path>で指定されたデフォルトComfyUIパス
  2. 最近実行または最近インストールされたComfyUI
  3. 現在のディレクトリの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"

トラブルシューティング

一般的な問題

  1. ワークスペースパスの問題

    # 現在のワークスペースをチェック
    comfy which
     
    # パスが間違っている場合、リセット
    comfy set-default /correct/path
  2. ノード競合の問題

    # bisect機能を使用して問題を特定
    comfy node bisect start
    # プロンプトに従って正常/異常状態をマーク
  3. 権限の問題

    # 十分な権限があることを確認
    ls -la ~/comfy

関連リンク