LinuxでのComfyUIのインストール方法
⚠️ 重要な注意： このドキュメントは常に最新の状態を保つとは限りません。最新で最も正確なインストール手順については、ComfyUI公式リポジトリを優先的に参照してください。特にAMD GPUサポートなどの特定の設定に関する詳細情報については、公式ドキュメントが最新情報の最良の情報源です。
LinuxでComfyUIをインストールする主な方法は2つあります：
- Comfy CLIを使用したインストール（推奨） - 最も簡単で高速な方法
- ComfyUIソースコードからのインストール - 従来の手動インストール方法
このチュートリアルでは、Comfy CLIインストールを推奨しながら、両方のインストール方法を詳細に説明します。
方法1：Comfy CLIを使用したComfyUIインストール（推奨）
Comfy CLIは、ComfyUIが提供する公式コマンドラインツールで、ComfyUIのインストールと管理プロセスを大幅に簡素化します。
ステップ1：システム環境の準備
1. Python環境の確認
ComfyUIはPython 3.12以上が必要です（Python 3.13を推奨）。Pythonのバージョンを確認してください：
python3 --version Pythonがインストールされていない、またはバージョンが古い場合は、以下の手順でインストールしてください：
Ubuntu/Debianシステム：
sudo apt update
sudo apt install python3 python3-pip python3-venvCentOS/RHEL/Fedoraシステム：
# CentOS/RHEL
sudo yum install python3 python3-pip
# またはFedora
sudo dnf install python3 python3-pipArch Linux：
sudo pacman -S python python-pip2. Gitのインストール（インストールされていない場合）
# Ubuntu/Debian
sudo apt install git
# CentOS/RHEL
sudo yum install git
# Fedora
sudo dnf install git
# Arch Linux
sudo pacman -S git3. 仮想環境の作成（推奨）
仮想環境を使用することで、パッケージの競合問題を回避できます：
# comfy-envという名前の仮想環境を作成
python3 -m venv comfy-env
# 仮想環境をアクティベート
source comfy-env/bin/activate注意： ComfyUIを使用する前に、毎回仮想環境をアクティベートする必要があります。仮想環境を終了するには、
deactivateコマンドを使用してください。
ステップ2：Comfy CLIのインストール
アクティベートされた仮想環境でcomfy-cliをインストールします：
pip install comfy-cliコマンドライン自動補完の設定（オプション）
より良いユーザーエクスペリエンスのために、コマンドライン自動補完を有効にできます：
comfy --install-completionステップ3：ComfyUIのインストール
comfy-cliを使用したComfyUIのインストールは非常に簡単で、1つのコマンドだけで完了します：
comfy installこのコマンドは以下を実行します：
- ComfyUIの最新バージョンをダウンロードしてインストール
- ComfyUI-Manager（ノードマネージャー）を自動的にインストール
- 基本的なプロジェクト構造を設定
インストールオプション
以下のオプションを使用してインストールをカスタマイズできます：
# デフォルトの場所~/comfyにインストール
comfy install
# 指定したディレクトリにインストール
comfy --workspace=/path/to/your/workspace install
# 現在のディレクトリにある既存のComfyUIで操作（主にアップデート用）
comfy --here install
# 最近実行または最近インストールされたComfyUIで操作
comfy --recent install
# ComfyUIのみをインストール、ComfyUI-Managerなし
comfy install --skip-managerインストールパスの確認
以下のコマンドを使用して現在のワークスペースを確認できます：
# デフォルトワークスペースを確認
comfy which
# 指定したオプションのワークスペースを確認
comfy --recent which
comfy --here whichステップ4：GPUサポートのインストール
NVIDIA GPU（CUDA）
NVIDIA GPUを使用している場合、CUDAサポートをインストールする必要があります：
# CUDAサポート付きPyTorchをインストール
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130注意： CUDAバージョンに応じて対応するPyTorchバージョンを選択してください。最新のインストールコマンドについてはPyTorchウェブサイトを参照してください。
AMD GPU（ROCm）
AMD GPUを使用している場合、ROCm版のPyTorchをインストールする必要があります。システムに応じて、以下のバージョンを試すことができます：
# ROCm 6.4を試す（推奨、6.0リンクが無効な場合）
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4
# またはROCm 6.0を試す
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0注意： あるROCmバージョンのリンクが無効な場合は、他のバージョンを試してください。最新のROCmインストールコマンドについてはPyTorchウェブサイトを参照することもできます。
ROCm公式でサポートされていないAMD GPUの場合
AMD GPUがROCm公式でサポートされていない場合（RX 6700、RX 6600、RX 7600など）、環境変数を使用してサポートを強制的に有効にできます：
RDNA2アーキテクチャGPU（RX 6700、RX 6600など）の場合：
HSA_OVERRIDE_GFX_VERSION=10.3.0 comfy launchRDNA3アーキテクチャGPU（RX 7600など）の場合：
HSA_OVERRIDE_GFX_VERSION=11.0.0 comfy launchソースコードインストール方式を使用する場合：
# RDNA2 GPU
HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py
# RDNA3 GPU
HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.pyAMD GPUパフォーマンス最適化のヒント
新しいPyTorchバージョンでは、実験的なメモリ効率的なアテンションメカニズムを有効にしてパフォーマンスを向上させることができます（RDNA3 GPUではデフォルトで有効）：
TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1 comfy launch -- --use-pytorch-cross-attention以下の環境変数を設定することも試せます。速度が向上する可能性があります（ただし、初回実行は遅くなります）：
PYTORCH_TUNABLEOP_ENABLED=1 comfy launchCPUのみ
CPUのみで実行する場合：
# CPU版PyTorchをインストール
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpuステップ5：ComfyUIの起動
インストール完了後、ComfyUIを起動します：
comfy launchデフォルトでは、ComfyUIはhttp://localhost:8188で実行されます。
一般的な起動オプション
# リッスンアドレスとポートを指定
comfy launch -- --listen 0.0.0.0 --port 8080
# CPUモードを使用
comfy launch -- --cpu
# 低VRAMモード
comfy launch -- --lowvram
# 超低VRAMモード
comfy launch -- --novram注意：
--backgroundパラメータは、一部のバージョンのComfyUIではサポートされていない可能性があります。バックグラウンドで実行する必要がある場合は、nohupやscreenなどのシステムレベルのツールの使用を検討してください。
方法2：ComfyUIソースコードからのインストール
従来のインストール方法を好む場合は、ソースコードから直接インストールすることもできます：
1. ComfyUIリポジトリのクローン
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI2. 仮想環境の作成
python3 -m venv venv
source venv/bin/activate3. 依存関係のインストール
pip install -r requirements.txt4. GPUサポートのインストール
GPUの種類に基づいて対応するPyTorchバージョンをインストールします（上記の手順を参照）。
5. ComfyUIの起動
python main.pyAMD GPUを使用していて問題が発生した場合は、以下のAMD GPUトラブルシューティングセクションを参照してください。
インストール後の設定
ベースモデルのインストール
ComfyUIが正常に動作するためには、ベースモデルが必要です。以下の方法があります：
- Hugging Faceからモデルをダウンロード
- モデルファイルを
models/checkpoints/ディレクトリに配置 - comfy-cliを使用してダウンロード：
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpointsトラブルシューティング
よくある問題
1. 権限の問題
権限の問題が発生した場合、インストールディレクトリへの書き込み権限があることを確認してください：
# デフォルトディレクトリを使用している場合、~/comfyディレクトリが書き込み可能であることを確認
ls -la ~/comfy2. Pythonバージョンの問題
正しいPythonバージョンを使用していることを確認してください：
python3 --version # 3.9以上である必要があります3. ネットワーク接続の問題
ダウンロードが遅い場合は、国内ミラーの使用を試してください：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comfy-cli4. GPU検出の問題
GPUが正しく認識されているかを確認してください：
import torch
print(torch.cuda.is_available()) # NVIDIA GPU
print(torch.version.cuda) # CUDAバージョン5. AMD GPUの問題
問題：起動時にNVIDIAドライバーが見つからないというエラーメッセージ
原因： ROCm版のPyTorchをインストールした後でも、システムがNVIDIAドライバーを検出したり、設定が正しくない場合、このエラーが発生する可能性があります。
解決策：
-
正しいROCmバージョンのPyTorchがインストールされていることを確認：
python -c "import torch; print(torch.__version__)" -
仮想環境内にいることを確認：
# 仮想環境がアクティベートされていることを確認 source comfy-env/bin/activate # または仮想環境のパス -
公式でサポートされていないAMD GPUの場合、環境変数を使用：
# RDNA2 GPU HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py # RDNA3 GPU HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py -
問題が続く場合は、CPUモードで起動を試す：
python main.py --cpu -
公式ドキュメントを参照： より多くのAMD GPU情報については、ComfyUI公式リポジトリのAMD GPUセクションを参照してください。
問題：ROCmリンクが無効
ROCm 6.0リンクが無効な問題が発生した場合は、以下を試してください：
- ROCm 6.4バージョンを使用
- PyTorchウェブサイトにアクセスして最新のインストールコマンドを取得
6. 仮想環境パスの問題
問題：ComfyUIを閉じた後、仮想環境パスが見つからない
解決策：
-
仮想環境の完全なパスを覚えておく：
# 仮想環境を作成する際、絶対パスを使用するか、相対パスを覚えておく cd ~/your-workspace python3 -m venv comfy-env -
使用前に毎回仮想環境をアクティベート：
# 仮想環境ディレクトリに移動 cd ~/your-workspace source comfy-env/bin/activate -
comfy-cliを使用して管理（推奨）： comfy-cliは仮想環境を自動的に管理するため、手動でアクティベートする必要はありません。
-
起動スクリプトを作成：
# start-comfy.shを作成 #!/bin/bash cd ~/your-workspace source comfy-env/bin/activate comfy launchその後、
chmod +x start-comfy.shで実行権限を追加。
7. PyTorchインストールの問題
問題：PyTorchのダウンロードが中断される（Killed）
解決策：
- システムスワップスペースを増やす（メモリ不足の場合）
- 国内ミラーを使用：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124 - 段階的にインストール：
pip install torch --index-url https://download.pytorch.org/whl/cu124 pip install torchvision --index-url https://download.pytorch.org/whl/cu124 pip install torchaudio --index-url https://download.pytorch.org/whl/cu124
まとめ
Comfy CLIを使用することは、LinuxでComfyUIをインストールする最良の方法で、以下を提供します：
- シンプルなインストールプロセス：1つのコマンドで完全インストール
- 完全な依存関係管理：すべての依存関係を自動的に処理
- マルチワークスペースサポート：複数のComfyUIインスタンスを管理可能
- クロスプラットフォーム互換性：Windows、macOS、Linuxで正常に動作
ComfyUIが初めての場合は、インストールと管理にComfy CLIの使用を強く推奨します。
次のステップ
インストール後、以下のことができます：
- 📖 完全なComfy CLIユーザーガイドを確認して、より高度な機能を学習
- 🎯 最初のComfyUIワークフローを開始
- 🔧 カスタムノードのインストールと管理
- 📦 モデルのダウンロードと管理
関連リンク
- 完全なComfy CLIユーザーガイド
- Comfy CLI GitHubリポジトリ
- Comfy CLI公式ドキュメント
- ComfyUI公式リポジトリ
- ComfyUI公式AMD GPUドキュメント
- PyTorchインストールガイド