ComfyUI-nunchaku
针对智算平台安装后无法找到节点的问题，本指南提供完整解决方案。请严格遵循以下步骤操作。
官方地址
- Github 源码：ComfyUI-nunchaku
- Hugging Face 仓库：nunchaku 模型文件
- ModelScope 镜像站: 国内镜像源
前提条件
默认情况下，通过 ComfyUI 的节点管理器安装的 ComfyUI-nunchaku 节点，可能会因为系统的Python或者PyTorch版本低，导致无法正常运行。
通过官方 Github 仓库上的说明文件：README.md中，我们可以了解到，目前该节点插件要求的最低版本是：
- Python 3.11
- PyTorch 2.6
为此我们需要了解我们自己的系统环境依赖是否满足这些要求。
查看系统环境依赖
我们进入到 GPU 的详情页，在终端中输入一下命令查看 Python 的版本：
python --version
可以看到演示的 GPU 实例它的 Python 版本是 3.11.12，是满足要求的。
接着我们查看 PyTorch 的版本：
pip show torch
可以看到 PyTorch 的版本是 2.5.1，是不满足要求的。
所以现在问题找到了，因为我们自己的系统环境依赖不满足要求，所以无法正常运行。
解决方案
步骤 1：获取适配的安装包
事实上官方提供了多种环境的安装文件，若系统环境不满足默认的依赖要求，就需要自己下载适配的安装包进行手动安装。
我们打开 Hugging Face 官方链接，可以看到在 Files and versions 标签下有多个安装文件：
文件名组成如下：
插件名-版本号-PyTorch版本-Python版本-系统版本.whl我们找到最新版本且符合我们 PyTorch2.5 版本的 linux 安装包：
其中cp311指的就是 Python 3.11，所以我们只需要找到符合系统版本的文件即可。
比如这里符合我们系统环境的文件是：nunchaku-0.3.1+torch2.5-cp311-cp311-linux_x86_64.whl。直接在网页该文件找到下载图标，右键复制链接地址，得到如下：
https://huggingface.co/mit-han-lab/nunchaku/resolve/main/nunchaku-0.3.1%2Btorch2.5-cp311-cp311-linux_x86_64.whl?download=true
步骤 2：虚拟环境安装
需要注意的是，智灵 GPU 实例它的 Python 是有虚拟环境的，默认情况下，如果你挂载了存储，那么虚拟环境的路径是：/root/ComfyUI/venv/bin。
你需要的插件或者依赖必须安装在虚拟环境下才能持久化，停止 GPU 实例再启动才不会丢失插件。
所以我们需要指定虚拟环境来进行安装，执行以下命令安装依赖：
/root/ComfyUI/venv/bin/pip install "https://huggingface.co/mit-han-lab/nunchaku/resolve/main/nunchaku-0.3.1%2Btorch2.5-cp311-cp311-linux_x86_64.whl?download=true"
直到控制台输出了Successfully installed 就表示安装成功。
步骤 3：安装 ComfyUI-nunchaku 节点
安装完成后停止 GPU 实例，再启动，再去 ComfyUI 的节点管理器中搜索nunchaku，找到ComfyUI-nunchaku节点，点击安装按钮：
这里我测试安装了最新的 0.3.2 和旧版 0.2.0 ，都可以正常运行。
安装完成后我们重启下 ComfyUI，就可以在节点列表中看到ComfyUI-nunchaku节点了：
重要提示
- 存储挂载用户必须通过虚拟环境安装：
/root/ComfyUI/venv/bin - 安装成功后终端会显示：
Successfully installed nunchaku-x.x.x - 支持版本兼容性：
- 已验证 0.3.2 与 0.2.0 版本均正常运行
- 建议优先选择最新稳定版