ComfyUI ModuleNotFoundError: No module named 'sageattention' 해결 가이드

No module named 'sageattention'가 보인다고 해서 항상 SageAttention을 설치해야 하는 것은 아닙니다.

많은 경우 이는 선택형 가속 backend가 없다는 warning입니다. 하지만 WanVideoWrapper, HunyuanVideo, LTX, Qwen Image 같은 동영상 워크플로에서는 queue 실행을 막는 실제 오류일 수도 있습니다.

1단계: 시작 warning인지 워크플로 실패인지 구분하기

로그가 아래처럼만 나오고:

[WARNING] Warning: Could not load sageattention: No module named 'sageattention'
[WARNING] sageattention package is not installed, sageattention will not be available

ComfyUI가 브라우저 UI까지 정상적으로 뜬다면 보통 긴급한 문제가 아닙니다.

SageAttention은 선택형 attention 가속 backend입니다. 많은 워크플로는 sdpa, comfy, torch, auto로 실행할 수 있습니다.

워크플로가 실제로 멈추고 동영상/attention 노드 주변 traceback이 나올 때만 다음 단계로 진행하세요.

2단계: 설치 전에 SageAttention 강제 사용을 끄기

시작 인수를 추가했다면

삭제합니다:

--use-sage-attention

ComfyUI를 재시작합니다.

노드에 attention backend 선택이 있다면

모델 로더, 동영상 wrapper, attention 관련 노드에서:

sageattn
sageattention
SageAttention

을 다음 중 하나로 바꿉니다:

sdpa
comfy
torch
auto

다시 queue를 실행합니다.

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

Windows에서 가장 흔한 실패는 시스템 Python에 설치하고 ComfyUI는 다른 Python을 쓰는 경우입니다.

Windows 포터블 버전

ComfyUI_windows_portable 폴더에서 PowerShell을 열고:

.\python_embeded\python.exe -s -c "import sys; print(sys.executable)"
.\python_embeded\python.exe -s --version

이후 모든 pip show, 설치, 제거, 검증은 같은 interpreter로 실행합니다.

수동 venv

ComfyUI 실행에 쓰는 venv를 활성화한 뒤:

python -c "import sys; print(sys.executable)"
python --version

시스템 Python, Conda, Windows Store Python이 아닌지 확인합니다.

4단계: Triton 확인

Windows에서 SageAttention 문제는 Triton에서 막히는 경우가 많습니다.

Windows 배포 패키지 이름은 보통:

triton-windows

Python import 이름은 여전히:

import triton

Windows 포터블 버전

.\python_embeded\python.exe -s -m pip show triton-windows
.\python_embeded\python.exe -s -c "import triton; print(triton.__version__)"

수동 venv

python -m pip show triton-windows
python -c "import triton; print(triton.__version__)"

import triton이 실패하면 SageAttention을 다시 설치하지 말고 Triton부터 고칩니다.

ComfyUI Triton 누락 또는 사용 불가

5단계: 정말 SageAttention 설치가 필요한지 결정

다음 경우에만 설치하세요:

• 워크플로에 sdpa, comfy, torch, auto 대안이 없음;
• 노드 또는 워크플로 작성자가 SageAttention을 명시적으로 요구함;
• 동영상 워크플로 최적화가 목적이고 Python/Torch/CUDA/Triton 호환성 문제를 처리할 준비가 됨.

단순 시작 warning 때문에 설치하지 마세요.

torch.cuda.is_available()가 false이거나, 실제 Python을 모른다거나, 완전히 맞는 build를 찾지 못하거나, sdpa / comfy로 실행된다면 설치하지 않는 편이 안전합니다.

6단계: 꼭 설치해야 한다면 환경을 기록하고 설치 가이드로 이동

Windows에는 모든 ComfyUI에 맞는 SageAttention 만능 명령이 없습니다.

먼저 기록합니다:

nvidia-smi

Windows 포터블 버전

.\python_embeded\python.exe -s --version
.\python_embeded\python.exe -s -m pip freeze > sageattention-before.txt
.\python_embeded\python.exe -s -c "import torch; print(torch.__version__); print(torch.version.cuda); print(torch.cuda.is_available())"

수동 venv

python --version
python -m pip freeze > sageattention-before.txt
python -c "import torch; print(torch.__version__); print(torch.version.cuda); print(torch.cuda.is_available())"

wheel을 고를 때는 nvidia-smi의 CUDA Version이 아니라 torch.version.cuda를 기준으로 합니다.

다음 설치 가이드로 이동하세요:

Windows ComfyUI에 SageAttention 설치

설치 가이드가 끝난 뒤 이 페이지의 7단계로 돌아와 검증합니다.

7단계: 설치 후 같은 Python에서 검증

Successfully installed만 믿지 마세요.

Windows 포터블 버전

.\python_embeded\python.exe -s -m pip show sageattention
.\python_embeded\python.exe -s -c "from sageattention import sageattn; print('SageAttention OK')"

수동 venv

python -m pip show sageattention
python -c "from sageattention import sageattn; print('SageAttention OK')"

이후 ComfyUI를 재시작하고 원래 워크플로를 다시 queue합니다.

No module named 'sageattention'가 DLL load failed while importing _fused로 바뀌었다면 설치한 build가 현재 런타임과 맞지 않는 것입니다. 추가 설치를 반복하지 말고 롤백하거나 호환 build를 선택하세요.

계속 실패할 때

관련 가이드

• Windows ComfyUI에 SageAttention 설치
• ComfyUI Triton 누락 또는 사용 불가
• ComfyUI 플러그인 import 실패
• ComfyUI 의존성 충돌
• ComfyUI 시작 실패

참고 자료

• SageAttention official GitHub repository
• SageAttention PyPI page
• ComfyUI command-line arguments
• ComfyUI issue: SageAttention installed into the wrong Python
• WanVideoWrapper issue: model loading cannot find SageAttention
• ComfyUI issue: SageAttention DLL load failed
• triton-windows PyPI page
• Triton Windows current project
• Triton Windows historical repository
• NVIDIA CUDA Toolkit, Driver, and Architecture Matrix