【ComfyUI】インストールエラーの主要原因と解決手順

ComfyUI インストールエラーが発生した場合の対処ガイド

冒頭

ComfyUIをインストールしようとした際、Windows環境を中心に様々なエラーが発生する場合があります。代表的な症状としては、セットアップ中にアプリが起動しない、依存関係のエラーが表示される、ComfyUI Managerのインストールに失敗する、またはディスク容量不足によるエラーなどが報告されています。本記事では、これらの一般的なインストールエラーに対する具体的な解決手順を解説します。

結論

ComfyUIのインストールエラーは、ディスク容量の確認、Gitのアップデート、Python依関係の再導入、ComfyUI Managerの手動インストールなどの手順で解決できる場合が多いです。以下ではステップバイステップで説明します。

具体的な手順

ステップ1: ディスク容量を確認する

ComfyUI Desktopをインストールするには、インストール先に少なくとも15GB以上の空き容量が必要です。一部のファイルはCドライブにもインストールされるため、ドライブの空き容量を確認してください。

確認方法:
- Windowsエクスプローラーで対象ドライブを右クリック
- 「プロパティ」→「空き容量」を確認
- 最低15GB以上の空きを確保すること

ステップ2: Gitを最新バージョンにアップデートする

古いGitバージョンはインストールエラー原因となる場合があります。最新版にアップデートしてください。

# Gitのバージョン確認（コマンドプロンプトまたはPowerShell）
git --version

# 最新版へのアップデートが必要な場合
# Git公式サイトから最新バージョンをダウンロードしてインストール
# https://git-scm.com/

ステップ3: ComfyUIを完全に閉じてからアップデートを実行する

ComfyUI Managerのインストールやアップデートは、ComfyUIが完全に終了した状態で行う必要があります。

# ComfyUIが起動している場合は完全に閉じる
# タスクマネージャーからComfyUI関連のプロセスを終了

# アップデーターファイルを実行
# 1. update.bat（または同等の更新ファイル）を実行
# 2. update_with_python_dependencies.batを実行

ステップ4: ComfyUI Managerの手動インストール（Git克隆）

Managerがインストールできない場合は、手動でGit克隆を行います。

# 手順
# 1. ファイルマネージャーで custom_nodes フォルダを開く
# 2. 空いているスペースをダブルクリック（または右クリック）
# 3. 「CMD」または「ターミナル здесь」と入力
# 4. 以下のコマンドを実行:

git clone https://github.com/ltdrdata/ComfyUI-Manager.git

# インストール後、ComfyUIを再起動

ステップ5: ログファイルの確認

エラーが解決しない場合は、ログファイルを確認して詳細なエラー原因を特定します。

# ログファイルの場所（Windowsの場合）
# %APPDATA%ComfyUIlogs
# または
# インストールディレクトリlogs

# ログファイル名例:
# comfyui.log
# output.log

# フォーラムに報告する際は:
# - 対応するログエラー
# - インターフェーススクリーンショット
# を添付すると解決が早まります

補足・注意点

バージョン依存: ComfyUIのバージョンによっては、古いバージョンでのみ発生するエラーもあります。最新版へのアップデートを検討してください。
環境差異: Windows、macOS、Linuxでインストール手順やエラー内容が異なる場合があります。本記事の内容は主にWindows環境を前提としています。
よく落ちる落とし穴:
- ディスク容量不足（15GB以上必要）
- Gitバージョンが古い
- Pythonパスが通っていない
- アンチウイルスソフトウェアによるブロック
- プロキシ設定の問題（法人環境の場合）
フォーラム検索: エラー解決前に、ComfyUI公式フォーラムやRedditで類似事例を検索すると、既知の解決策が見つかる場合があります。