Nunchaku 黑科技：ComfyUI 终极加速与显存优化#

MIT Han Lab 发布的黑科技量化技术——Nunchaku。它基于强大的 SVDQuant 技术，能让你在享受更快生图速度和更低显存占用的同时，获得几乎无损的画质！

更令人兴奋的是，在最新的版本中，Nunchaku 已经全面兼容几乎所有的 Flux 生态插件，包括 LoRA, ControlNet, Redux, PuLID 等。官方还雄心勃勃地计划在未来版本中，支持目前市面上效果最好的开源视频生成模型 Sora-level Wan2.1。

这篇教程将手把手带你完成 Nunchaku 的安装和配置，让我们开始吧！

小提示：从源码安装的过程比较复杂，强烈建议使用官方编译好的 wheel 文件来安装，省时省力！

🚀 第一步：安装前准备，检查环境#

在开始安装之前，我们需要确认一下你的 ComfyUI 环境是否满足要求。

确认 PyTorch 版本 Nunchaku 要求 PyTorch 版本 大于或等于 2.5。你可以在启动 ComfyUI 时，在命令行窗口（小黑窗）的顶部看到你的环境版本信息。

例如，你会看到类似下面这样的输出：
```
1
Python version: 3.12.9 (main, Nov 14 2022, 16:10:14) [GCC 11.3.0]
2
PyTorch version: 2.7.0+cu128
```
请记下你的 Python version 和 Pytorch version，下一步会用到。

下载预编译的 Wheel 文件 前往 Nunchaku 的 Hugging Face 仓库下载已经编译好的 .whl 文件。
- 下载地址: https://huggingface.co/mit-han-lab/nunchaku/tree/main
你需要根据上一步记录的版本信息，找到完全匹配的文件。文件名结构如下： nunchaku-0.3.1+torch2.7-cp312-cp312-win_amd64.whl
- nunchaku-0.3.1: 插件版本号
- torch2.7: 对应你的 pytorch version: 2.7.0+cu128
- cp312: 对应你的 Python version: 3.12.9
- win_amd64: 对应 Windows 系统
请仔细核对，下载与你环境完全对应的文件。
执行安装命令
- 将下载好的 .whl 文件放在你的 ComfyUI 根目录下。
- 打开命令行窗口，进入 ComfyUI 根目录，执行以下命令来安装：
Terminal window
```
1
.\.venv\Scripts\python.exe -m pip install nunchaku-0.3.1+torch2.7-cp312-cp312-win_amd64.whl
```
注意：请将上面的文件名替换成你实际下载的文件名！
（可选）升级或重装 如果你之前安装过旧版本的 Nunchaku，建议先卸载再安装新版本，以确保环境纯净。
Terminal window
```
1
.\.venv\Scripts\python.exe -m pip uninstall nunchaku
```
卸载后，再回到上面的步骤，下载并安装最新的 wheel 文件。