パッケージ不足
ComfyUI で No module named 'cv2' が出る時の直し方
Partially verifiedMedium riskTested on Windows 10, Windows 11 | portable | Python 3.11 | CUDA 12.x | Torch 2.x | ComfyUI portable and manual venv patternsLast verified 2026-05-21Estimated time 5-15 minutes
OpenCV の不足や競合で発生する cv2 エラーを、正しい Python 環境と単一 OpenCV flavor の原則で修復する。
この問題が実際の ComfyUI 環境に影響しているなら、まず Wonderful Launcher で現在のマシンを確認し、ドキュメントを見ながら修復方針を決めてください。
Wonderful Launcher をダウンロードcv2 は OpenCV の import 名です。
ComfyUI では画像前処理、姿勢推定、動画フレーム処理などでよく使われます。
よくある原因
- ComfyUI の Python に OpenCV が入っていない
- OpenCV の flavor を複数混在させた
- NumPy / DLL 不整合で import に失敗している
推奨方針
ComfyUI では opencv-python-headless を 1 種類だけ入れる ところから始めるのが安全です。
手順
1. 現状確認
python -m pip list | findstr opencv2. 混在していたら整理
python -m pip uninstall -y opencv-python opencv-python-headless opencv-contrib-python opencv-contrib-python-headless
python -m pip install opencv-python-headless3. 検証
python -c "import cv2; print(cv2.__version__)"注意
opencv-python系を複数残さない- まず NumPy 全体を下げに行かない
- package は ComfyUI と同じ Python に入れる
関連ページ
この問題が実際の ComfyUI 環境に影響しているなら、まず Wonderful Launcher で現在のマシンを確認し、ドキュメントを見ながら修復方針を決めてください。
Wonderful Launcher をダウンロード関連ガイド：Start from the No module named hubRepair dependency conflictsFix MMCV install failuresFix plugin import failures
この問題が実際の ComfyUI 環境に影響しているなら、まず Wonderful Launcher で現在のマシンを確認し、ドキュメントを見ながら修復方針を決めてください。
Wonderful Launcher をダウンロードDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.