ComfyUI의 No module named 에러를 고치는 방법

ComfyUI의 ModuleNotFoundError / No module named 에러를 패키지명, Python 환경, 커스텀 노드 의존성, CUDA / PyTorch 불일치 기준으로 분류합니다.

ComfyUI 에서 ModuleNotFoundError: No module named ... 가 뜨면, 보이는 패키지 부족 자체보다 어느 Python 환경이 ComfyUI 를 시작했는지 가 더 중요합니다.

Windows portable 패키지라면 대부분의 복구 명령은 다음 형태여야 합니다.

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

수동 Git 설치라면 ComfyUI 를 실행한 것과 같은 venv 를 활성화한 뒤:

python -m pip ...

바로 확인할 것

로그 위치	흔한 원인	첫 확인
`custom_nodes` 에서 발생	커스텀 노드 의존성 누락	해당 플러그인 폴더와 `requirements.txt`
`ComfyUI\\comfy\\...` 에서 발생	ComfyUI 코어 의존성 누락/드리프트	`ComfyUI\\requirements.txt`
`pip install` 성공 후에도 동일	잘못된 Python 에 설치	ComfyUI Python 에서 `pip show`
재시작 후 다른 에러로 바뀜	첫 번째 막힘을 고치고 다음 문제가 드러남	새 첫 traceback 추적
CUDA / DLL / wheel 오류	네이티브 또는 GPU 의존성	Torch / CUDA 확인

Step 1: 정확한 모듈명을 복사

추측한 패키지명이 아니라 로그의 줄 자체로 시작하세요.

ModuleNotFoundError: No module named 'sageattention'

모듈의 import 이름과 pip 패키지명은 항상 같지 않습니다.

Step 2: ComfyUI 를 시작한 Python 찾기

portable:

.\python_embeded\python.exe -s -m pip --version
.\python_embeded\python.exe -s -m pip show <package-name>

수동 venv:

python -m pip --version
python -m pip show <package-name>

Step 3: 지금 고쳐야 하는 에러인지 분류

모듈	보통 얼마나 치명적인가	메모
`torch`	매우 높음	ComfyUI 본체가 못 뜰 수 있음
`transformers`	높음	tokenizer / text stack 에 걸림
`cv2`	중간	이미지/비디오 계열 노드에 흔함
`onnxruntime`	workflow 의존	얼굴/포즈/헬퍼 노드
`sageattention`	선택적인 경우 많음	launch flag 나 특정 workflow 에서만 필요
`triton`	선택적인 경우 많음	가속 또는 특정 노드 의존

Step 4: 가능한 한 좁게 고치기

관련 있어 보이는 패키지를 한 번에 다 넣지 마세요. 하나 고친 뒤 다시 시작하고, 새로운 첫 번째 에러 를 읽는 편이 안전합니다.

Step 5: import 검증 후 재시작

python -c "import <module_name>; print('import ok')"

portable:

.\python_embeded\python.exe -s -c "import <module_name>; print('import ok')"

Still stuck after the manual fix?

Preserve the environment, collect the startup log, and use Wonderful Launcher diagnostics as the next step instead of trying random package installs.

Open diagnostics path

Related errors

바로 확인할 것

로그 위치	흔한 원인	첫 확인
`custom_nodes` 에서 발생	커스텀 노드 의존성 누락	해당 플러그인 폴더와 `requirements.txt`
`ComfyUI\\comfy\\...` 에서 발생	ComfyUI 코어 의존성 누락/드리프트	`ComfyUI\\requirements.txt`
`pip install` 성공 후에도 동일	잘못된 Python 에 설치	ComfyUI Python 에서 `pip show`
재시작 후 다른 에러로 바뀜	첫 번째 막힘을 고치고 다음 문제가 드러남	새 첫 traceback 추적
CUDA / DLL / wheel 오류	네이티브 또는 GPU 의존성	Torch / CUDA 확인

Step 1: 정확한 모듈명을 복사

추측한 패키지명이 아니라 로그의 줄 자체로 시작하세요.

ModuleNotFoundError: No module named 'sageattention'

모듈의 import 이름과 pip 패키지명은 항상 같지 않습니다.

Step 2: ComfyUI 를 시작한 Python 찾기

portable:

.\python_embeded\python.exe -s -m pip --version
.\python_embeded\python.exe -s -m pip show <package-name>

수동 venv:

python -m pip --version
python -m pip show <package-name>

Step 3: 지금 고쳐야 하는 에러인지 분류

모듈	보통 얼마나 치명적인가	메모
`torch`	매우 높음	ComfyUI 본체가 못 뜰 수 있음
`transformers`	높음	tokenizer / text stack 에 걸림
`cv2`	중간	이미지/비디오 계열 노드에 흔함
`onnxruntime`	workflow 의존	얼굴/포즈/헬퍼 노드
`sageattention`	선택적인 경우 많음	launch flag 나 특정 workflow 에서만 필요
`triton`	선택적인 경우 많음	가속 또는 특정 노드 의존

Step 4: 가능한 한 좁게 고치기

관련 있어 보이는 패키지를 한 번에 다 넣지 마세요. 하나 고친 뒤 다시 시작하고, 새로운 첫 번째 에러 를 읽는 편이 안전합니다.

Step 5: import 검증 후 재시작

python -c "import <module_name>; print('import ok')"

portable:

.\python_embeded\python.exe -s -c "import <module_name>; print('import ok')"

Still stuck after the manual fix?

Preserve the environment, collect the startup log, and use Wonderful Launcher diagnostics as the next step instead of trying random package installs.

Open diagnostics path

ComfyUI의 No module named 에러를 고치는 방법

Related errors

바로 확인할 것

Step 1: 정확한 모듈명을 복사

Step 2: ComfyUI 를 시작한 Python 찾기

Step 3: 지금 고쳐야 하는 에러인지 분류

Step 4: 가능한 한 좁게 고치기

Step 5: import 검증 후 재시작

Still stuck after the manual fix?

관련 문서

목차

ComfyUI의 No module named 에러를 고치는 방법

Related errors

바로 확인할 것

Step 1: 정확한 모듈명을 복사

Step 2: ComfyUI 를 시작한 Python 찾기

Step 3: 지금 고쳐야 하는 에러인지 분류

Step 4: 가능한 한 좁게 고치기

Step 5: import 검증 후 재시작

Still stuck after the manual fix?

관련 문서

목차