ComfyUI No module named 및 ModuleNotFoundError 오류 복구 가이드

패키지명 불일치, Python 가상환경 불일치, 커스텀 노드 의존성 및 CUDA/PyTorch 버전 충돌로 인한 ComfyUI ModuleNotFoundError 해결법.

ComfyUI 실행 시 터미널 콘솔창에 ModuleNotFoundError: No module named ... 오류가 출력된다면, 본 페이지는 패키지별 문제 해결을 돕는 통합 복구 허브 페이지입니다. 이미 어떤 라이브러리가 유실되었는지 파악하고 계시다면, 아래의 개별 라이브러리 상세 가이드 링크로 즉시 이동하십시오.

Python 의존성 문제를 해결하는 데 있어 가장 중요한 핵심은 **"어떤 Python 가상환경 경로를 대상으로 pip 명령을 실행할 것인가"**를 올바르게 판별하는 것입니다.

공식 Windows Standalone 포터블 버전인 경우 포터블 루트 폴더에서 내장 파이썬 경로를 가리켜 설치해야 합니다.

.\python_embeded\python.exe -s -m pip install <패키지명>

수동 설치 환경 (Git + venv)인 경우 활성화된 가상환경 셸 경로상에서 다음 명령어로 설치합니다.

python -m pip install <패키지명>

신속 진단 가이드

터미널 표시 로그	예상 원인	우선 점검 사항
`custom_nodes` 내 경로에서 `ModuleNotFoundError`	커스텀 노드가 구동 시 요구하는 패키지 유실	해당 노드 폴더 내 `requirements.txt` 확인
`ComfyUI\comfy\...` 내 경로에서 `ModuleNotFoundError`	ComfyUI 코어 패키지 버전 훼손 또는 유실	ComfyUI 루트 디렉토리 내 `requirements.txt` 확인
`pip install`은 성공했는데 동일 에러가 반복됨	엉뚱한 Python 환경(시스템 기본 환경 등)에 라이브러리가 깔림	런타임 Python 경로를 지정해 `pip show <패키지명>` 조회
조치 후 재시작하니 다른 에러 명칭으로 바뀜	최초 락을 해제하자 그 다음 순서의 누락 패키지가 노출됨	정상적인 복구 진전이므로 새로운 최초 에러를 다시 해소
CUDA 가속, DLL 바인딩, 혹은 휠(wheel) 에러가 남	패키지 설치 시 특정 GPU 연산 컴파일러 드라이버가 꼬임	패키지 추가 조치 전에 PyTorch / CUDA의 통신 상태 검증

빈번하게 검출되는 핵심 유실 모듈 목록

원격 로그 분석 결과, 발생 빈도가 가장 높은 모듈 리스트는 다음과 같습니다.

누락 모듈 명칭	대상 기능군	상세 복구 가이드
`triton`	FLUX, 비디오 연산 가속, 고급 연산자 스택	`triton` 문제 복구
`sageattention`	Wan-Video 등 고성능 프레임 가속 플러그인	`sageattention` 문제 복구
`onnx` / `onnxruntime`	DWPose, ReActor 등 ONNX 추론 노드 스택	`onnx` 및 `onnxruntime` 복구
`llama_cpp`	로컬 LLM 연동, 프롬프트 인코딩 강화 노드	修复 `llama_cpp` 问题
`insightface`	얼굴 감지, 얼굴 교체(ReActor) 필수 패키지	修复 `insightface` 问题
`cv2`	이미지 자르기, 리사이즈, OpenCV 가반 영상 연산 노드	`cv2` 문제 복구
`nunchaku`	Nunchaku 양자화 FLUX/Qwen/SANA 워크플로	`nunchaku` 문제 복구
`kornia`	이미지 필터링, morphology, Canny 연산자 노드	修复 `kornia` 问题
`spandrel`	초해상도 업스케일러 모델 로더 (`nodes_upscale_model.py`)	修复 `spandrel` 问题
`simpleeval`	수식 연산 노드 (`nodes_math.py`)	修复 `simpleeval` 问题
`pydantic_settings`	설정 분석 패키지 바인딩	修复 `pydantic_settings` 问题
`yaml` / `PIL`	패키지명 불일치 함정: `PyYAML` / `Pillow`를 깔아야 함	修复 `yaml` 또는 修复 `PIL`
`safetensors`	Safetensors 모델 텐서 정보 해독용 라이브러리	修复 `safetensors` Python 包
`einops`	텐서 모양 변환, ControlNet 모델 등 연산 보조	修复 `einops` 问题
`scipy`	과학 계산, 오디오/비디오 프레임 가공 보조	修复 `scipy` 问题
`torchsde`	SDE 확률미분방정식 수치 연산 샘플러	修复 `torchsde` 问题
`av`	PyAV 영상 프레임 인/디코딩 파서	修复 `av` 问题
`aiohttp` / `requests`	외부 API 통신, 웹 통신 클라이언트 패키지	修复 `aiohttp` 또는 修复 `requests`

라이브러리 임포트 이름과 패키지 등록 이름 비교

Python 코딩 시 사용되는 임포트 선언 명칭과 pip install 시 쓰이는 패키지 공식 명칭은 다른 경우가 많아 설치 시 주의를 요합니다.

코드 선언명 (에러 로그명)	실제 pip 설치용 패키지명	올바른 설치 명령어 형태
`cv2`	`opencv-python-headless`	`pip install opencv-python-headless`
`yaml`	`PyYAML`	`pip install PyYAML`
`PIL`	`Pillow`	`pip install Pillow`
`segment_anything`	`segment-anything`	`pip install segment-anything`
`llama_cpp`	`llama-cpp-python`	`pip install llama-cpp-python`

Related errors

신속 진단 가이드

터미널 표시 로그	예상 원인	우선 점검 사항
`custom_nodes` 내 경로에서 `ModuleNotFoundError`	커스텀 노드가 구동 시 요구하는 패키지 유실	해당 노드 폴더 내 `requirements.txt` 확인
`ComfyUI\comfy\...` 내 경로에서 `ModuleNotFoundError`	ComfyUI 코어 패키지 버전 훼손 또는 유실	ComfyUI 루트 디렉토리 내 `requirements.txt` 확인
`pip install`은 성공했는데 동일 에러가 반복됨	엉뚱한 Python 환경(시스템 기본 환경 등)에 라이브러리가 깔림	런타임 Python 경로를 지정해 `pip show <패키지명>` 조회
조치 후 재시작하니 다른 에러 명칭으로 바뀜	최초 락을 해제하자 그 다음 순서의 누락 패키지가 노출됨	정상적인 복구 진전이므로 새로운 최초 에러를 다시 해소
CUDA 가속, DLL 바인딩, 혹은 휠(wheel) 에러가 남	패키지 설치 시 특정 GPU 연산 컴파일러 드라이버가 꼬임	패키지 추가 조치 전에 PyTorch / CUDA의 통신 상태 검증

빈번하게 검출되는 핵심 유실 모듈 목록

원격 로그 분석 결과, 발생 빈도가 가장 높은 모듈 리스트는 다음과 같습니다.

누락 모듈 명칭	대상 기능군	상세 복구 가이드
`triton`	FLUX, 비디오 연산 가속, 고급 연산자 스택	`triton` 문제 복구
`sageattention`	Wan-Video 등 고성능 프레임 가속 플러그인	`sageattention` 문제 복구
`onnx` / `onnxruntime`	DWPose, ReActor 등 ONNX 추론 노드 스택	`onnx` 및 `onnxruntime` 복구
`llama_cpp`	로컬 LLM 연동, 프롬프트 인코딩 강화 노드	修复 `llama_cpp` 问题
`insightface`	얼굴 감지, 얼굴 교체(ReActor) 필수 패키지	修复 `insightface` 问题
`cv2`	이미지 자르기, 리사이즈, OpenCV 가반 영상 연산 노드	`cv2` 문제 복구
`nunchaku`	Nunchaku 양자화 FLUX/Qwen/SANA 워크플로	`nunchaku` 문제 복구
`kornia`	이미지 필터링, morphology, Canny 연산자 노드	修复 `kornia` 问题
`spandrel`	초해상도 업스케일러 모델 로더 (`nodes_upscale_model.py`)	修复 `spandrel` 问题
`simpleeval`	수식 연산 노드 (`nodes_math.py`)	修复 `simpleeval` 问题
`pydantic_settings`	설정 분석 패키지 바인딩	修复 `pydantic_settings` 问题
`yaml` / `PIL`	패키지명 불일치 함정: `PyYAML` / `Pillow`를 깔아야 함	修复 `yaml` 또는 修复 `PIL`
`safetensors`	Safetensors 모델 텐서 정보 해독용 라이브러리	修复 `safetensors` Python 包
`einops`	텐서 모양 변환, ControlNet 모델 등 연산 보조	修复 `einops` 问题
`scipy`	과학 계산, 오디오/비디오 프레임 가공 보조	修复 `scipy` 问题
`torchsde`	SDE 확률미분방정식 수치 연산 샘플러	修复 `torchsde` 问题
`av`	PyAV 영상 프레임 인/디코딩 파서	修复 `av` 问题
`aiohttp` / `requests`	외부 API 통신, 웹 통신 클라이언트 패키지	修复 `aiohttp` 또는 修复 `requests`

라이브러리 임포트 이름과 패키지 등록 이름 비교

Python 코딩 시 사용되는 임포트 선언 명칭과 pip install 시 쓰이는 패키지 공식 명칭은 다른 경우가 많아 설치 시 주의를 요합니다.

코드 선언명 (에러 로그명)	실제 pip 설치용 패키지명	올바른 설치 명령어 형태
`cv2`	`opencv-python-headless`	`pip install opencv-python-headless`
`yaml`	`PyYAML`	`pip install PyYAML`
`PIL`	`Pillow`	`pip install Pillow`
`segment_anything`	`segment-anything`	`pip install segment-anything`
`llama_cpp`	`llama-cpp-python`	`pip install llama-cpp-python`

ComfyUI No module named 및 ModuleNotFoundError 오류 복구 가이드

Related errors

신속 진단 가이드

빈번하게 검출되는 핵심 유실 모듈 목록

라이브러리 임포트 이름과 패키지 등록 이름 비교

관련 가이드

목차

ComfyUI No module named 및 ModuleNotFoundError 오류 복구 가이드

Related errors

신속 진단 가이드

빈번하게 검출되는 핵심 유실 모듈 목록

라이브러리 임포트 이름과 패키지 등록 이름 비교

관련 가이드

목차