Nunchaku가 2025년 6월 1일 날짜로 업데이트 되었습니다.

이와 관련한 설치관련 내용을 공유 드립니다.

이 가이드는 제 설치영상 https://www.youtube.com/watch?v=BXgNNu4OASU 대로 설치한 git clone 버전 기준입니다. ComfyUI Portable, Stability Matix 버전은 각자의 python 폴더에 설치하는 방법으로 진행하세요.

사전에 CUDA Toolkit 및 Visual Studio 2022 빌드 도구 설치가 되어 있어야 합니다. 자세한 내용은 https://www.notion.so/ComfyUI-Nunchaku-1f982da2981f8093bce2f215e6d8d688를 참고해주세요.

https://www.youtube.com/watch?v=Zvot1nuFq-k

사전 다운로드

0.3.0 업데이트 이후 더이상 폴더채로 모델을 가져가지 않고, 단일 파일로 제공됩니다. 각각의 파일을 다운로드 후 Models/diffusion_models에 넣어주시면 됩니다.

일반적으로는 int4라고 기재된 파일을 받으시고, 블랙웰 아키텍처(RTX 5xxx)는 fp4라고 기재된 파일을 받으시면 됩니다.

• nunchaku-flux.1-dev https://huggingface.co/mit-han-lab/nunchaku-flux.1-dev/tree/main
• nunchaku-flux.1-fill-dev https://huggingface.co/mit-han-lab/nunchaku-flux.1-fill-dev/tree/main
• nunchaku-flux.1-schnell https://huggingface.co/mit-han-lab/nunchaku-flux.1-schnell/tree/main
• nunchaku-flux.1-depth-dev https://huggingface.co/mit-han-lab/nunchaku-flux.1-depth-dev/tree/main
• nunchaku-flux.1-canny-dev https://huggingface.co/mit-han-lab/nunchaku-flux.1-canny-dev/tree/main

1. torch 삭제 및 2.7 버전 설치

윈도우 명령 프롬프트 (cmd) 또는 PowerShell에서 아래 내용대로 입력하세요.

토치 삭제
pip uninstall torch torchvision torchaudio

토치 2.7 설치
[CUDA 12.8 사용자 기준]
pip install torch torchvision torchaudio --index-url <https://download.pytorch.org/whl/cu128>

2. Nunchaku Whl 파일 설치

여기서 반드시 본인의 PC에 설치된 python 버전과 torch 버전을 확인하고 copy download link를 클릭해서 해당 whl 파일의 설치 링크를 가지고 옵니다.

mit-han-lab/nunchaku at main