ComfyUI에서 No module named 'insightface'가 뜰 때의 Windows 복구

No module named 'insightface' 는 system Python 이 아니라 ComfyUI 를 실제로 시작한 Python 환경 을 고쳐야 해결됩니다.

Windows 에서 pip install insightface 를 바로 치면 소스 빌드로 넘어가면서 C++ 컴파일 오류가 나는 경우가 많습니다. 가능하면 Python 버전에 맞는 wheel 을 먼저 쓰고, 얼굴 workflow 가 실제로 필요할 때만 ONNX Runtime 까지 추가하세요.

언제 필요한가

• ReActor face swap
• IPAdapter FaceID
• InstantID
• PuLID

얼굴 관련 노드가 필요 없는 workflow 라면 굳이 지금 설치할 필요는 없습니다.

먼저 확인

• 에러를 낸 노드가 정말 face workflow 인가
• 패키지를 넣는 위치가 ComfyUI 의 Python 인가
• onnxruntime 까지 필요한 노드인가

portable 기준:

.\python_embeded\python.exe -s -m pip show insightface

Windows 에서 자주 막히는 이유

• PyPI insightface 는 소스 배포라 빌드 도구를 요구함
• 잘못된 Python 에 설치함
• NumPy / ONNX Runtime 스택이 이미 꼬여 있음

복구 순서

1. ComfyUI Python 을 확인한다.
2. 해당 Python 에서 insightface wheel 을 설치한다.
3. workflow 가 요구하면 onnxruntime 또는 onnxruntime-gpu 를 추가한다.
4. 다시 시작해서 import 가 통과하는지 본다.

portable 예시:

.\python_embeded\python.exe -s -m pip install insightface
.\python_embeded\python.exe -s -c "import insightface; print('import ok')"

설치가 wheel 없이 빌드로 넘어가며 실패한다면, Python 버전과 맞는 Windows wheel 경로를 다시 확인하세요.

자주 하는 실수

• system Python 에 설치하고 ComfyUI 는 그대로 실패
• insightface 없이 먼저 onnxruntime-gpu 부터 넣음
• 얼굴 노드 하나 때문에 NumPy 전체를 성급히 내림

관련 문서

• ComfyUI ONNX / ONNXRuntime Missing
• ComfyUI Plugin Import Failed
• ComfyUI No Module Named