⚠️ Dependency Troubleshooting Guide

How to Fix "No module named insightface" in ComfyUI

Install precompiled binary C++ wheels for ReActor, InstantID, and Face Analysis nodes without Visual Studio build tools.

Error Signature:ModuleNotFoundError: No module named 'insightface'

⚡ Quick Direct Answer

Install a precompiled wheel corresponding to your Python version instead of running a raw pip install.

Why Does This Error Happen?

Custom nodes like ReActor or InstantID require InsightFace, which depends on C++ build compilation and fails on Windows when Microsoft C++ Build Tools are missing.

Recommended Terminal Repair Commands

Windows (ComfyUI Portable):

.\python_embeded\python.exe -m pip install onnxruntime-gpu insightface --extra-index-url https://download.pytorch.org/whl/cu121

Linux / macOS (Virtualenv):

pip install onnxruntime-gpu insightface

Still Crashing on Your Local GPU?

Skip compilation conflicts and memory limits by deploying on high-VRAM Cloud GPUs starting at pennies/hour.

Deploy on Vast.ai Deploy on RunPod

Frequently Asked Questions

Why does normal pip install insightface fail with "error: Microsoft Visual C++ 14.0 or greater is required"?

The InsightFace PyPI source package must be compiled into C++ binaries. If your Windows installation lacks the 6GB Visual Studio C++ Compiler tools, downloading precompiled wheels bypasses the compilation step completely.