ComfyUI ポータブル版の欠落依存関係を1つずつ修復する方法
検証済みの Windows ポータブル版 ComfyUI 修復手順。SQLAlchemy、torch、フロントエンドパッケージ、kornia、PyOpenGL などの欠落の解決法。
Windows ポータブル版の ComfyUI 環境が、コアパッケージの欠如によって起動に失敗した場合、すぐにすべてを再インストールする必要はありません。
推奨される修復サイクルは以下の通りです：
- ComfyUI を起動する。
- ログに出現する最初の新しいインポートエラー（
ModuleNotFoundError等）を読み取る。 python_embededパスの Python のみを使用して該当パッケージをインストールする。- 再度起動する。
- サーバーが正常に立ち上がり、エラーログが消失するまで上記の手順を繰り返す。
本ページの内容は、2026年5月18日の実際の破損環境の修復手順に基づいています。検証は ModuleNotFoundError: No module named 'sqlalchemy' から始まり、最終的に CUDA 搭載の PyTorch を利用する RTX 4070 Ti SUPER 環境での復旧に成功しました。
実践の原則
一度にインストールするパッケージは 1 つだけにしてください。インストール後に再起動し、新たなエラーがないかを確認します。長大な一括インストールコマンドを乱発するのではなく、毎回ログを確認することで環境破壊の二次災害を防ぐことができます。
解決手順の適用基準
環境そのものの基礎的な起動依存関係が不足して起動できない場合に本ガイドを適用してください。特定のカスタムノードのインポートエラーに留まる場合は、別のガイドを優先します。
| 現在の状態 | より適切なガイド |
|---|---|
| サーバー起動前（Starting server に到達する前）に停止し、再起動のたびに別のモジュール欠如が出る | 本ガイド（逐次修復サイクル） |
特定のカスタムノード1つだけが IMPORT FAILED になる | ComfyUI 插件导入失败 |
| 赤色ノードは表示されるが、ComfyUI 自体は起動する | ComfyUI 缺失节点 を経て、該当ノードの登録状況を確認 |
| Torch はインポートできるが、CUDA が無効化されている | パッケージのインストール前に Torch 未编译 CUDA 支持 を優先 |
| ノードは登録されているが、モデルファイルが欠落している | Safetensors 放置位置 または 找不到模型文件 |
修復された依存関係のログ推移（実例）
以下は、実際に破損した環境を復旧させた際に入力したコマンドとエラーログの推移です。
| 試行回数 | エラーログ | 実行したインストール | 導入後の変化 |
|---|---|---|---|
| 1 | ModuleNotFoundError: No module named 'sqlalchemy' | pip install "SQLAlchemy>=2.0" | filelock の不足へ進む |
| 2 | ModuleNotFoundError: No module named 'filelock' | pip install filelock | alembic と yaml の不足へ進む |
| 3 | Error importing dependencies: No module named 'alembic' | pip install alembic | データベース初期化プロセスへ進む |
| 4 | ModuleNotFoundError: No module named 'yaml' | pip install PyYAML | PIL の不足へ進む |
| 5 | ModuleNotFoundError: No module named 'PIL' | pip install Pillow | tqdm の不足へ進む |
| 6 | ModuleNotFoundError: No module named 'tqdm' | pip install tqdm | 見慣れない内部モジュール風の import エラーへ進む |
| 7 | 見慣れない ComfyUI 内部モジュール風の ModuleNotFoundError | ローカル requirements または公式 ComfyUI パッケージメタデータを確認してから判断する | import 名から PyPI パッケージ名を推測しない |
| 8 | ModuleNotFoundError: No module named 'torch' | ComfyUI Torch Missing に従い、embedded Python に合う CUDA wheel を選ぶ | CUDA を検証してから次へ進む |
| 9 | ModuleNotFoundError: No module named 'safetensors' | pip install safetensors | packaging の不足へ進む |
| 10 | ModuleNotFoundError: No module named 'packaging' | pip install packaging | numpy の不足へ進む |
| 11 | ModuleNotFoundError: No module named 'numpy' | pip install "numpy>=1.25.0" | einops の不足へ進む |
| 12 | ModuleNotFoundError: No module named 'einops' | pip install einops | psutil の不足へ進む |
| 13 | ModuleNotFoundError: No module named 'psutil' | pip install psutil | VRAM検出へ進み、torchvision の不足へ進む |
| 14 | ModuleNotFoundError: No module named 'torchvision' | CUDA wheel インデックスから torchvision をインストール | torchaudio の不足へ進む |
| 15 | ModuleNotFoundError: No module named 'torchaudio' | 同インデックスから torchaudio をインストール | scipy の不足へ進む |
| 16 | ModuleNotFoundError: No module named 'scipy' | pip install scipy | transformers の不足へ進む |
| 17 | ModuleNotFoundError: No module named 'transformers' | pip install transformers | torchsde の不足へ進む |
| 18 | ModuleNotFoundError: No module named 'torchsde' | pip install torchsde | av の不足へ进む |
| 19 | ModuleNotFoundError: No module named 'av' | pip install av | aiohttp の不足へ進む |
| 20 | ModuleNotFoundError: No module named 'aiohttp' | pip install aiohttp | requests の不足へ進む |
| 21 | ModuleNotFoundError: No module named 'requests' | pip install requests | pydantic の不足へ進む |
| 22 | ModuleNotFoundError: No module named 'pydantic' | pip install pydantic | comfyui-frontend-package の不足へ進む |
| 23 | comfyui-frontend-package is not installed | pip install comfyui-frontend-package | サーバー起動。ただし一部内蔵拡張ノードが失敗 |
サーバー起動後、一部の警告ログや内蔵機能の欠落に対するクリーンアップ手順：
| 警告・エラーログ | 実行したインストール | 解決した内容 |
|---|---|---|
Canny やモルフォロジーノードで No module named 'kornia' | pip install kornia | ロードされるノード数が 657 から 685 へ増加 |
nodes_upscale_model.py で No module named 'spandrel' | pip install spandrel | ノード数が 687 へ増加 |
pyproject.toml 解析時に No module named 'pydantic_settings' | pip install pydantic-settings | 警告ログの量が減少 |
OpenGL dependencies not available | pip install PyOpenGL 後に pip install glfw | GLSL/OpenGL ノードがインポート成功 |
nodes_math.py で No module named 'simpleeval' | pip install simpleeval | 起動ログから IMPORT FAILED 行が消失 |
comfyui-workflow-templates is not installed | pip install comfyui-workflow-templates | テンプレート警告が消失 |
comfyui-embedded-docs package not found | pip install "comfyui-embedded-docs==0.4.4" | ドキュメント警告が消失 |
ステップ 0：ポータブル版のルートディレクトリから開始
以下のファイルやフォルダが含まれるディレクトリで PowerShell ターミナルを開きます：
run_nvidia_gpu.bat
run_cpu.bat
python_embeded
ComfyUI内蔵 Python の実行環境パスを確認します：
.\python_embeded\python.exe -s -c "import sys; print(sys.executable); print(sys.version)"これが ComfyUI を起動する Python であることを確認してください。
ステップ 1：起動ログを記録しながらの修復
1つずつ修復する際、以下のコマンドで起動テスト時のログを記録すると便利です：
$ts = Get-Date -Format 'yyyyMMdd_HHmmss'
New-Item -ItemType Directory -Force .\repair_logs | Out-Null
$out = ".\repair_logs\attempt_${ts}_stdout.log"
$err = ".\repair_logs\attempt_${ts}_stderr.log"
Start-Process -FilePath ".\python_embeded\python.exe" `
-ArgumentList @("-s", "ComfyUI\main.py", "--windows-standalone-build") `
-WorkingDirectory (Get-Location) `
-RedirectStandardOutput $out `
-RedirectStandardError $err `
-PassThru出力されたエラーログを確認します：
Get-Content $err -Tail 200そこに出ている最初の致命的エラーのモジュールのみをインストールし、再び起動テストを行います。
ステップ 2：ポート 8188 の確認
起動テストを行う際、すでに別の ComfyUI などのプロセスがポート 8188 を使用していると、修復中の環境が正常起動したかどうかの判別が難しくなります。
ポートの使用状況を確認します：
Get-NetTCPConnection -LocalPort 8188 -ErrorAction SilentlyContinue |
Select-Object LocalAddress,LocalPort,State,OwningProcess競合がある場合は、別のクリーンなポートを指定して起動検証を行います：
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --port 8191ステップ 3：Torch の CUDA サポート検証
起動エラーに No module named 'torch' が表示される場合、単に pip install torch を行うと CPU-only 版が入るリスクがあります。PyTorch 公式インストール選択ツールから環境に合う CUDA wheel を選び、embedded Python で実行してください：
.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXXcuXXX は対応する CUDA wheel タグに置き換えます。第三者ミラーを主コマンドに混ぜないでください。その後、以下のコマンドで CUDA が使えることを確認します：
.\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')"ステップ 4：フロントエンド等パッケージのバージョン固定
ログに以下のエラーが表示される場合：
comfyui-frontend-package is not installed.インストールする前に、ComfyUI\requirements.txt を読み、そこに指定されているフロントエンドのバージョン（例：1.42.15）と一致するパッケージを指定してインストールしてください。
関連ガイド
実際の ComfyUI 環境で起きている問題なら、まず無料で Wonderful Launcher を使って確認してください。ランチャー内の修復フロー、タスクログ、実行環境チェックを一か所で確認できます。クレジットは画像生成と従量ツール用です。
Wonderful Launcher をダウンロードクレジットプランを見るDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.