ComfyUI ModuleNotFoundError: No module named 'torch' 해결

ComfyUI를 시작한 Python이 Torch를 import하지 못하면 ComfyUI는 **ModuleNotFoundError: No module named 'torch'**에서 멈춥니다. 사용자는 보통 No module named torch 또는 **ComfyUI torch missing**으로도 찾습니다. 이는 핵심 런타임 문제이며 무시해도 되는 경고가 아닙니다.

해결 원칙은 단순합니다. 실제로 ComfyUI를 실행하는 Python에 CUDA용 Torch를 설치하고, 그 빌드가 CPU-only가 아닌지 확인합니다.

.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXX

cuXXX는 PyTorch 공식 설치 선택기에서 현재 환경에 맞는 CUDA wheel 태그로 바꾸세요. 다시 실행하기 전에 torch.version.cuda가 None이 아니고 torch.cuda.is_available()가 True인지 확인합니다.

빠른 판단

1단계: ComfyUI가 실제로 쓰는 Python 확인

Windows 포터블:

.\python_embeded\python.exe -s -c "import sys; print(sys.executable)"
.\python_embeded\python.exe -s -m pip show torch torchvision torchaudio

수동 venv:

.\venv\Scripts\activate
python -c "import sys; print(sys.executable)"
python -m pip show torch torchvision torchaudio

ComfyUI Desktop이나 다른 관리형 런처를 쓰는 경우 앱이 제공하는 터미널 또는 환경 도구를 사용하세요. python_embeded가 항상 있다고 가정하면 안 됩니다.

2단계: 활성 환경에 Torch 설치

GPU, 드라이버, Python 버전, 지원되는 PyTorch 빌드에 맞춰 PyTorch 공식 설치 선택기에서 CUDA wheel을 고르세요. bare pip install torch로 시작하지 마세요. import는 고쳐져도 CPU-only wheel이 설치될 수 있습니다.

Windows 포터블에서는 선택한 명령을 embedded Python으로 실행합니다.

.\python_embeded\python.exe -s -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cuXXX

수동 venv는 먼저 활성화한 뒤 같은 --index-url 패턴으로 python -m pip를 실행합니다. cuXXX는 지원되는 CUDA wheel 태그로 바꿉니다.

3단계: CPU Torch가 아닌지 확인

ComfyUI를 시작하는 같은 Python에서 실행합니다.

.\python_embeded\python.exe -s -c "import torch; print(torch.__version__, torch.version.cuda, torch.cuda.is_available()); print(torch.cuda.get_device_name(0) if torch.cuda.is_available() else 'no cuda')"

버전이 +cpu로 끝나고 None False가 나오면 CPU-only 빌드입니다. 2단계의 CUDA wheel 명령을 다시 실행하세요. 지역 미러를 주 설치 명령에 섞지 말고, 네트워크 접근 문제와 패키지 출처 검증은 따로 처리합니다.

Torch import는 되지만 CUDA가 계속 실패하면 ComfyUI Torch Not Compiled With CUDA Enabled를 보세요.

4단계: 다시 시작하고 다음 첫 오류 읽기

.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build

손상된 포터블 환경에서는 다음 차단점이 safetensors, packaging, numpy, torchvision, torchaudio 같은 다른 핵심 패키지로 넘어갈 수 있습니다. 같은 Python에서 "다음 첫 오류"를 순서대로 고치세요. 핵심 패키지가 계속 연쇄적으로 깨진다면 ComfyUI 포터블 의존성을 한 패키지씩 복구하는 런북을 사용하세요.

하지 말아야 할 것

• ComfyUI가 python_embeded 또는 venv에서 실행되는데 시스템 Python에 Torch를 설치하지 않기
• import torch 성공을 CUDA 복구 성공으로 착각하지 않기
• 일반 wheel 기반 ComfyUI 환경에서 CUDA Toolkit 재설치부터 시작하지 않기
• 원인 파악 전에 pip install -r부터 실행하지 않기
• 핵심 런타임이 정상화되기 전에 custom node를 다시 설치하지 않기

관련 가이드

• ComfyUI Torch Not Compiled With CUDA Enabled
• ComfyUI 포터블 의존성을 한 패키지씩 복구하기
• ComfyUI comfyui-frontend-package is not installed
• ComfyUI 의존성 충돌
• Custom node 설치 후 ComfyUI가 깨졌을 때 복구하기

참고

• PyTorch Start Locally installer