ComfyUI で No module named 'insightface' が出る時の直し方

ComfyUI で No module named 'insightface' が出たら、system Python ではなく ComfyUI を起動している Python 環境 を直してください。

よくある症状

• ReActor が読み込まれない
• InstantID / FaceID / PuLID ノードが import failed
• pip install insightface が Windows でコンパイル失敗する

原因

insightface は人顔認識系ライブラリです。 Windows ではソースビルドに入りやすく、C++ 環境が無いと失敗しがちです。

手順

1. 正しい Python を使う

portable:

.\python_embeded\python.exe -s --version

venv:

python --version

2. 対応 wheel を入れる

Windows ではコミュニティ配布 wheel を使う方が安全です。 Python 3.11 の例:

python -m pip install https://github.com/Gourieff/Assets/raw/main/Insightface/insightface-0.7.3-cp311-cp311-win_amd64.whl

portable なら python -m pip を .\python_embeded\python.exe -s -m pip に置き換えます。

3. 必要なら ONNX Runtime

CPU だけなら：

python -m pip install onnxruntime

GPU が必要なら：

python -m pip install onnxruntime-gpu

注意点

• pip install insightface を盲目的に実行しない
• NumPy を最初から下げない
• ONNX Runtime の GPU 版は CUDA 構成と合っている必要がある

検証

python -c "import insightface; print(insightface.__version__)"

関連ページ

• ComfyUI ONNX Missing
• ComfyUI Plugin Import Failed