ComfyUI ModuleNotFoundError: No module named 'torch' の修復

ComfyUI を起動した Python が Torch を import できないと、ComfyUI は ModuleNotFoundError: No module named 'torch' で停止します。No module named torch や ComfyUI torch missing として検索されることもあります。これは中核ランタイムの失敗であり、無視できる警告ではありません。

修復の基本は、ComfyUI を実際に起動している Python に CUDA 版 Torch を入れ、そのビルドが CPU-only ではないことを確認することです。

.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXX

cuXXX は、PyTorch 公式インストール選択ツールで自分の環境に合う CUDA wheel タグに置き換えてください。再起動前に torch.version.cuda が None ではなく、torch.cuda.is_available() が True になることを確認します。

早見表

Step 1: ComfyUI が実際に使う Python を確認する

Windows ポータブル版:

.\python_embeded\python.exe -s -c "import sys; print(sys.executable)"
.\python_embeded\python.exe -s -m pip show torch torchvision torchaudio

手動 venv:

.\venv\Scripts\activate
python -c "import sys; print(sys.executable)"
python -m pip show torch torchvision torchaudio

ComfyUI Desktop や別の管理ランチャーを使っている場合は、そのアプリが用意するターミナルまたは環境ツールを使ってください。python_embeded が必ず存在するとは限りません。

Step 2: 有効な環境に Torch を入れる

GPU、ドライバ、Python バージョン、対応している PyTorch build に合わせて、PyTorch 公式インストール選択ツールから CUDA wheel を選びます。裸の pip install torch から始めないでください。import は直っても CPU-only wheel が入ることがあります。

Windows ポータブル版では、選んだコマンドを embedded Python 経由で実行します。

.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXX

手動 venv では、先に venv を有効化し、同じ --index-url パターンで python -m pip を実行します。cuXXX は対応する CUDA wheel タグに置き換えます。

Step 3: CPU Torch を入れていないか確認する

ComfyUI を起動する同じ Python で実行します。

.\python_embeded\python.exe -s -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available()); print(torch.cuda.get_device_name(0) if torch.cuda.is_available() else 'no cuda')"

出力のバージョン末尾が +cpu で、None False が出る場合は CPU-only build です。Step 2 の CUDA wheel コマンドを再実行してください。地域ミラーを主コマンドに混ぜず、ネットワーク問題とパッケージの出所確認は分けて扱います。

Torch は import できるのに CUDA がまだ失敗する場合は、ComfyUI の Torch Not Compiled With CUDA Enabled に進みます。

Step 4: 再起動して次の最初のエラーを読む

.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build

壊れたポータブル環境では、次の阻害要因が safetensors、packaging、numpy、torchvision、torchaudio など別の中核パッケージに移ることがあります。同じ Python で「次の最初のエラー」を順番に直してください。中核パッケージが連鎖的に壊れている場合は、ポータブル版依存関係を一つずつ修復する手順を使います。

やってはいけないこと

• ComfyUI が python_embeded や venv から起動しているのに、システム Python に Torch を入れない
• import torch が成功しただけで CUDA も直ったと思わない
• 通常の wheel ベースの ComfyUI 環境で、最初に CUDA Toolkit を入れ直さない
• 何が壊れているか分かる前に pip install -r から始めない
• 中核ランタイムが正常になる前に custom node を入れ直さない

関連ガイド

• ComfyUI の Torch Not Compiled With CUDA Enabled
• ポータブル版依存関係を一つずつ修復する手順
• ComfyUI で comfyui-frontend-package is not installed が出る場合
• ComfyUI の依存関係競合
• Custom node を入れて ComfyUI が壊れた場合の復旧

参考

• PyTorch Start Locally installer