ComfyUI-nunchaku插件

前言

​ ComfyUI-nunchaku 是一个为 ComfyUI 提供的插件，用于高效运行使用 SVDQuant 量化的 4 位神经网络。该插件提供了多种功能节点，支持图像生成、LoRA 应用和各种条件控制。

---

安装方法

Nunchaku v0.2.0安装

第一种

通过manager搜索 nunchaku下载即可。

第二种

1. 进入 ComfyUI 的 custom_nodes 目录，并打开cmd
2. 使用以下命令克隆仓库：

git clone https://github.com/mit-han-lab/ComfyUI-nunchaku.git

注：安装Nunchaku v0.2.0版本还需要安装Nunchaku提供的whl库文件。下载地址：Nunchaku v0.2.0，一定要下载和自己torch和python环境对应的版本

如果是ComfyUI便携包版本，下载完最好放到ComfyUI的内置python文件夹后，进入该文件夹之后，window内置python环境则进行cmd进行安装

==内置python环境==

python -m pip install nunchaku-0.2.0+torch2.5-cp311-cp311-win_amd64.whl

==虚拟环境==

pip install nunchaku-0.2.0+torch2.5-cp311-cp311-win_amd64.whl

==linux环境==

pip install nunchaku-0.2.0+torch2.5-cp311-cp311-linux_x86_64.whl

---

nunchaku v0.3.0安装

如果已经安装nunchaku v0.2.0的用户，在更新ComfyUI-nunchaku插件时，可能会报该错误No module named 'nunchaku.models.pulid'

解决该问题只需要安装nunchaku v0.3.0的whl文件，下载地址：点击跳转，(一定要下载和自己torch和python环境对应的版本)

<img src="assets/image-20250603154825912.png" alt="image-20250603154825912" style="zoom: 80%;" />

如果是ComfyUI便携包版本，下载完最好放入XX/ComfyUI/python_embeded文件夹后，进入该文件夹之后，windows内置python环境则打开cmd进行安装

==内置python环境==

python -m pip install nunchaku-0.3.0.dev20250521+torch2.5-cp311-cp311-win_amd64.whl

==虚拟环境==

pip install nunchaku-0.3.0.dev20250521+torch2.5-cp311-cp311-win_amd64.whl

==linux环境==

pip install nunchaku-0.3.0.dev20250521+torch2.5-cp311-cp311-linux_x86_64.whl

到此，一般安装完nunchaku v0.3.0的whl文件，重启ComfyUI没有报错最好，但是也有可能安装完之后可能还是会报错No module named 'nunchaku.merge_safetensors'

解决该问题需要下载下面这个文件，地址：点击跳转

找到ComfyUI中python的的nunchaku环境包，然后使用上面下载的Source code文件夹中的nunchaku直接替换python环境包中的nunchaku文件夹。最后重启ComfyUI即可。

---

模型下载

1. 国内用户可从魔搭社区下载：ModelScope，HuggingFace下载：HuggingFace

2. 进入模型页面后，以上面红框内模型为例，其他模型的下载也是一样。该模型需要放置在ComfyUI/models/diffusion_models文件夹。

3. 进入模型下载界面后，需要把里面的所有文件都下载，并且在diffusion_models新建一个文件夹，以模型名称命名。

4. 如果您觉得一个一个的文件下载麻烦，也可以使用命令操作，点击下载模型，里面会有命令下载方式