【ComfyUI】requirements.txtを使ったPython環境構築と依存関係インストール法

ComfyUIのセットアップで困っていませんか？

ComfyUIをインストールしようとした際、Python環境の準備や必要なライブラリのインストール方法で迷う方も多いのではないでしょうか。「pip installコマンドが効かない」「必要なライブラリが何かわからない」「Pythonバージョンが合わない」といったエラーに遭遇した場合、この記事が帮助你解決します。

結論：requirements.txtを使って一括インストール

ComfyUIの公式リポジトリには、必要な依存関係（外部ライブラリ）がrequirements.txtファイルとしてまとめられています。このファイルを使用すれば、コマンド一つで全ての必要なライブラリをインストール可能です。

具体的な設置手順

ステップ1：Pythonのインストール

まず、Python環境を用意します。ComfyUIは現在Python 3.12を推奨しています（注：Python 3.13には対応していないライブラリがあるため、3.12以前のバージョンを使用してください）。

# Python 3.12.7のインストール（Windowsの場合）
# 公式HPからダウンロード: https://www.python.org/downloads/
# インストール時に「Add Python to PATH」にチェックを入れることを忘れずに

ステップ2：ComfyUIリポジトリのクローン

GitHubからComfyUIのソースコードをダウンロードします。

# Gitがインストールされている場合
git clone https://github.com/comfyanonymous/ComfyUI.git

# またはzipファイルとしてダウンロードした場合
# 解凍后将フォルダ名を「ComfyUI」に変更

ステップ3：requirements.txtを使用した依存関係のインストール

ComfyUIフォルダに移動し、requirements.txtを使って必要なライブラリを一括インストールします。

# ComfyUIディレクトリに移動
cd ComfyUI

# 依存関係をインストー（すべてのライブラリが自動インストールされる）
pip install -r requirements.txt

このコマンドにより、PyTorchや画像処理所需的ライブラリが自動的にインストールされます。インストールが完了すると、ComfyUIを起動する準備が整います。

ステップ4：ComfyUIの起動確認

# ComfyUIを起動
python main.py

ブラウザで「http://127.0.0.1:8188」にアクセスし、ComfyUIのインターフェースが表示されれば成功です。

補足・注意点

Pythonバージョンについて

推奨バージョン：Python 3.12（公式 также 3.10~3.11は動作報告あり）
非対応：Python 3.13（一部の依存ライブラリが未対応のため）
バージョン確認方法：python --version

動作環境

OS：Windows 10以降（Mac/Linuxも可能だが、Windows Native Installation教程などを参照）
メモリ：最低8GB、複雑な画像処理には32GB以上を推奨
ディスク容量：少なくとも10GB以上を確保（モデルファイル）

よくある落とし穴

PATH設定の見落とし：Pythonインストール時に「Add Python to PATH」にチェックを入れないと、pipコマンドが認識されません
管理者権限：インストール時にエラーが出る場合、コマンドプロンプトを「管理者として実行」してください
GPUドライバー：NVIDIA GPUを使用する場合は、最新版のCUDA ToolkitとGPUドライバーをインストールしてください
既存環境との競合：他のPythonプロジェクトがある人は、仮想環境（venvまたはConda）の使用を推奨

仮想環境を使う場合（推奨）

# venvによる仮想環境の作成
python -m venv venv

# 仮想環境の有効化
venvScriptsactivate

# 依存関係のインストール
pip install -r requirements.txt

まとめ

ComfyUIのセットアップは、Python 3.12をインストール → リポジトリをクローン → pip install -r requirements.txtを実行というシンプルな流れで完了します。Python 3.13は非対応なので注意してください。Disk容量とメモリを確保し、正しいバージョンを使えば、スムーズにComfyUIを導入できます。