ComfyUI の更新方法

ComfyUI の更新については、さまざまなインストール方法に沿って複数のセクションで説明してきましたが、この包括的なガイドではすべての更新手順を統合し、ユーザーが ComfyUI の更新方法を明確に理解できるよう支援します。

ComfyUI の更新方法

ポータブル
デスクトップ
手動インストール

ComfyUI ポータブル版では、簡単な更新のために便利なバッチスクリプトを提供しています。

更新スクリプトの場所

ポータブルインストールディレクトリ内の update フォルダーに、以下の更新スクリプトがあります：

ComfyUI_windows_portable
└─ 📂update
   ├── update.py
   ├── update_comfyui.bat                           // 最新開発バージョンに更新
   ├── update_comfyui_stable.bat                    // 最新安定バージョンに更新
   └── update_comfyui_and_python_dependencies.bat   // ⚠️ 危険：依存関係を再インストール - 競合を引き起こす可能性あり

更新中は安定したインターネット接続を確保してください。

⚠️ 危険：update_comfyui_and_python_dependencies.bat は非常に注意して使用してください！このスクリプトは通常の更新よりも包括的で、以下を実行します：

✅ ComfyUI コード自体を更新
✅ PyTorch を更新（NVIDIA GPU CUDA 12.9 用）
✅ すべての Python 依存関係を再インストール

リスク：

既存の設定と依存関係の競合を引き起こす可能性
特定のパッケージバージョンに依存するカスタムノードを破損する可能性
手動で設定したパッケージを上書きする可能性

⚠️ このスクリプトを使用するのは以下の場合のみ：

依存関係の問題を修正する必要がある場合
メジャーバージョンの更新を実行する場合
日常の更新には、代わりに update_comfyui.bat を使用してください

このスクリプトを実行する前に：

ComfyUI インストール全体をバックアップ
インストールしたカスタムパッケージのバージョンを文書化
必要に応じてカスタムノードを再インストールする準備をする

手動インストールされた ComfyUI は、更新を完了するために Git コマンドが必要です。

更新前の要件

システムに Git がインストールされており、ComfyUI が Git clone 経由でインストールされていることを確認してください。

更新手順

仮想環境をアクティブ化

まず、ComfyUI の Python 仮想環境をアクティブ化します（使用している場合）：

# conda 環境の場合
conda activate comfyui

# venv 環境の場合
# Windows
venv\Scripts\activate
# macOS/Linux  
source venv/bin/activate

バージョン切り替え（オプション）

特定のバージョンに切り替えるには、以下のコマンドを使用します：

# コミット履歴を表示
git log --oneline

# 特定のコミットに切り替え
git checkout <commit-hash>

# 最新バージョンに戻る
git checkout master

最新の機能とセキュリティ修正のために定期的な更新を推奨しますが、システムの安定性のために安定バージョンを推奨します

ComfyUI バージョンタイプ

インストール方法に応じて、ComfyUI にはいくつかのインストールバージョンがあります。以下のリンクには、各バージョンの更新手順が含まれています。

Comfy デスクトップ版

Comfy Desktop は Windows と macOS（Apple Silicon） でのスタンドアロンインストールに対応しています。Linux はソースからのみです（公式インストーラーはまだありません）。

ソースは GitHub にあります

Desktop インストールはデフォルトで ComfyUI の 安定版 を追跡します。常に最新のコミットが必要な場合は、ポータブル版か手動 git インストールを使うか、インスタンスの更新チャネルを Latest on GitHub に切り替えてください。

以下から、お使いのシステムとハードウェアに合ったインストールを選んでください

Windows
macOS (Apple Silicon)
Linux

Comfy Desktop（Windows）インストールガイド

Windows 10 以降向け。NVIDIA または AMD GPU を推奨。

ComfyUI ポータブル版（Windows）

ポータブル版は、独立した埋め込み型 Python 環境を統合した ComfyUI のバージョンです。このバージョンを利用することで、最新の機能をいち早く体験できます。現在は Windows システムのみをサポートしています。

ComfyUI ポータブル版（Windows）インストールガイド

NVIDIA GPU または CPU 専用環境 で動作する Windows 向け ComfyUI バージョンをサポート。常に最新のコミットを反映し、完全にポータブルです。

手動インストール

ComfyUI 手動インストールガイド

すべての OS（Windows/macOS/Linux）および GPU（NVIDIA、AMD、Intel、Apple Silicon、Ascend NPU、Cambricon MLU）に対応しています。

ComfyUI を更新する際に更新が必要なものは？

ComfyUI の更新は主に 2 つのコンポーネントで構成されます：

ComfyUI のコアコードを更新
ComfyUI のコア依存関係を更新（必要な Python 依存関係と ComfyUI 機能依存パッケージを含む）

コアコード：新しいノード、新しいモデルサポート、新機能など コア依存関係：主に ComfyUI のフロントエンド機能、ワークフローテンプレート、ノードヘルプドキュメントなどを含む

comfyui-frontend-package   # ComfyUI フロントエンド機能
comfyui-workflow-templates # ComfyUI ワークフローテンプレート  
comfyui-embedded-docs      # ComfyUI ノードヘルプドキュメント
comfy-kitchen              # ComfyUI コアユーティリティ
comfy-aimdo                # ComfyUI コアユーティリティ

これらのコア依存関係は、別のリポジトリで管理されています：

ComfyUI_frontend - フロントエンドインターフェースとインタラクティブ機能
workflow_templates - 事前構築されたワークフローテンプレート
comfyui-embedded-docs - ノードヘルプドキュメント
comfy-kitchen - 複数の計算バックエンドを持つ Diffusion 推論用の高速カーネルライブラリ
comfy-aimdo - AI モデル必要オフローディングアロケータ

開発バージョン（nightly）と安定バージョン（release）の違いを理解することが重要です：

開発バージョン（nightly）：最新のコミットコード。最新機能にアクセスできますが、潜在的な問題を含む可能性があります
安定バージョン（release）：安定リリースに基づいて構築。通常は開発バージョンより遅れますが、より高い安定性を提供します。機能のテストと安定化後に安定バージョンをサポートします

多くのユーザーは、更新中にリリースバージョンまたはデスクトップバージョンを使用していますが、必要な機能が開発バージョンでのみ利用可能であることに気づきます。そのような場合は、ローカルの ComfyUI/requirements.txt が nightly バージョン依存関係と一致しているか確認し、すべての依存関係が最新機能をサポートしているかを判断してください。

一般的な更新問題

更新後にフロントエンド、ワークフローテンプレート、ノードが欠落または古くなっている

依存関係が正しく更新されていない
依存関係の更新失敗

ユーザーは git pull コマンドのみを使用して ComfyUI コードを更新しますが、コア依存関係の更新を怠ることが多く、以下の問題が発生します：

フロントエンド機能の欠落または異常
新しく追加されたワークフローテンプレートが見つからない
ノードヘルプドキュメントが古いか欠落
新機能に対応するフロントエンドサポートがない

git pull コマンドを使用した後、対応する ComfyUI 環境で pip install -r requirements.txt を使用して依存関係を更新してください。

依存関係の更新が失敗する場合、ネットワークまたはコンピューターの権限問題が一般的です。更新中にコア依存関係の失敗が発生すると、システムは古いバージョンにフォールバックします。起動中に通常以下のようなログが表示されます：

Falling back to the default frontend.
ComfyUI frontend version: xxx

以下のトラブルシューティング手順に従ってください：

適切な環境で pip list を使用して、現在インストールされている依存パッケージを表示します。バージョンの不一致が見つかった場合は、ComfyUI 環境で pip install -r requirements.txt を使用して依存関係の更新を再試行してください。
更新後も問題が解決しない場合は、ネットワーク接続を確認してください。中国本土のユーザーは、GitHub リポジトリに確実にアクセスするためにプロキシを構成する必要がある場合があります。
問題が継続する場合は、コンピューターの権限を確認してください。管理者権限が必要な場合は、管理者権限でコマンドラインを実行してください。

コア依存関係を正しく更新する方法

ポータブル版
手動インストール
デスクトップ版

推奨方法：ComfyUI_windows_portable\update\update_comfyui.bat バッチスクリプトを使用します。このスクリプトは、ComfyUI のコードとすべての Python 依存パッケージを同時に更新します。手動での依存パッケージ更新：
依存パッケージを手動で更新する必要がある場合は、以下のコマンドを使用してください：

# ポータブル版のディレクトリ内でコマンドラインを開く
.\python_embeded\python.exe -m pip install -r ComfyUI\requirements.txt

標準的な更新手順：

Python 環境の有効化

Conda を使用して Python 環境を管理している場合、まず対象の環境を有効化してください：

conda activate comfyui  # または他の環境名

コードの更新

ComfyUI のルートディレクトリに移動し、Git を用いてコードを更新します：

cd <ComfyUI_ROOT_PATH>
git pull

依存パッケージの更新

ComfyUI の依存パッケージを更新します。このステップは特に comfyui-frontend-package の更新において非常に重要です：

pip install -r requirements.txt

コア依存関係の更新トラブルシューティング

コア依存関係の更新が失敗した場合、以下のトラブルシューティング手順に従ってください：

ネットワーク接続を確認

中国本土にいる場合は、PyPI にアクセスできるか、または国内ミラーを構成していることを確認してください：

# 清華大学ミラーを使用
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

コアパッケージを個別にインストール

バッチインストールが失敗する場合は、パッケージを個別にインストールしてみてください。まず ComfyUI/requirements.txt のバージョン要件を確認：その後、指定されたバージョンに従ってインストール（requirements.txt のバージョン番号を使用）：

pip install comfyui-frontend-package==<version> 
pip install comfyui-workflow-templates==<version>
pip install comfyui-embedded-docs==<version>
pip install comfy-kitchen==<version>
pip install comfy-aimdo==<version>

ComfyUI/requirements.txt に指定された正確なバージョン番号を使用することを推奨します。互換性の問題を引き起こす可能性があるため、独自に最新バージョンにアップグレードしないでください。

更新後に新機能が見つからないのはなぜ？

これは最も一般的な問題の 1 つです：

デスクトップ版を使用している場合、デスクトップ版は安定リリースに基づいて構築されているため、機能が遅れる場合があります
**開発バージョン（nightly）**を使用していることを確認し、**安定バージョン（release）**ではないことを確認してください

さらに、更新プロセス中に対応する依存関係が正常に更新されたことを確認してください。更新後も問題が解決しない場合は、依存関係の更新トラブルシューティングセクションを参照して問題を診断してください。

開発（Nightly）バージョンと安定（Release）バージョンを切り替える方法

バージョン間の違い：

開発バージョン (Nightly)
安定バージョン (Release)

特徴：最新のコミットコードを含む
利点：最新の機能と改善を最初に体験できる
リスク：未発見のバグまたは不安定な要素を含む可能性
適している：開発者、テスター、最新機能を体験したいユーザー

ポータブル
手動インストール
デスクトップ

update_comfyui_stable.bat ではなく update_comfyui.bat を使用：

# 開発バージョン（最新機能）
double-click: update_comfyui.bat

# 安定バージョン
double-click: update_comfyui_stable.bat

# 開発バージョンに切り替え
git checkout master
git pull

# 最新安定バージョンに切り替え
git fetch --tags
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

更新後にエラーが発生した場合はどうすればよい？

依存関係を確認：pip install -r requirements.txt を実行し、すべての依存関係が更新されていることを確認
カスタムノードを確認：一部のカスタムノードは新しいバージョンと互換性がない場合がある
バージョンをロールバック：問題が深刻な場合は、以前の安定バージョンにロールバック可能

問題が発生した場合は、解決策についてはトラブルシューティングページを参照してください。

トラブルシューティング

ComfyUI の問題のトラブルシューティング方法を学ぶ

新機能の最新情報を入手する方法

GitHub Releases：安定バージョンの更新については ComfyUI Releases を確認
GitHub Commits：開発の進捗状況については最新コミットを表示
コミュニティディスカッション：最新情報についてはブログと Twitter をフォロー

はじめに

Agent Tools / MCP

基本概念

インターフェースガイド

チュートリアル

パートナーノード

ComfyUI の更新方法