如何正确安装nunchaku-0.3.0.dev0与torch2.6在Windows？

Question

在安装 nunchaku-0.3.0.dev0 与 PyTorch 2.6 的过程中，用户常遇到“依赖冲突”或“找不到兼容版本”的问题。这是由于 nunchaku 是一个较为小众的第三方库，其当前版本可能未适配最新版 PyTorch，或者其依赖项与 torch 2.6 中的组件存在版本不兼容。此外，Windows 系统在使用 pip 安装某些依赖时可能会缺少必要的构建工具或编译环境，导致安装失败。如何在 Windows 上正确配置 Python 环境、安装 torch 2.6，并顺利安装与之兼容的 nunchaku 版本？这是本课题的核心技术难点。

Answer 1

一、环境准备与版本选择

在 Windows 系统上安装 PyTorch 2.6 和 nunchaku-0.3.0.dev0 之前，必须确保 Python 环境正确配置。推荐使用 Python 3.10，因为 PyTorch 2.6 对 Python 版本有明确要求，且与大多数现代第三方库兼容。

建议使用 Miniconda 创建虚拟环境，以隔离不同项目之间的依赖冲突。例如：

conda create -n torch26 python=3.10
conda activate torch26

这样可以避免全局 Python 环境被污染，也便于调试不同版本的依赖。

二、安装 PyTorch 2.6

访问 PyTorch 官网 获取安装命令，选择对应操作系统（Windows）、包管理器（pip）和 Python 版本。例如：

pip install torch==2.6.0+cu118 torchvision==0.17.0+cu118 torchaudio==2.6.0 --extra-index-url https://download.pytorch.org/whl/cu118

注意：如果你使用的是 CPU 版本，则应去掉 +cu118，并使用：

pip install torch==2.6.0 torchvision==0.17.0 torchaudio==2.6.0

安装完成后，验证是否成功：

python -c "import torch; print(torch.__version__)"

三、处理 nunchaku 安装的依赖冲突

nunchaku 是一个非主流的第三方库，可能尚未适配 PyTorch 2.6。尝试安装：

pip install nunchaku==0.3.0.dev0

若提示如下错误：

ERROR: Could not find a version that satisfies the requirement torch==1.13.1 (from nunchaku) (from versions: 2.6.0, ...)

说明 nunchaku 的依赖项中明确指定了旧版本的 PyTorch，与当前安装的 2.6 不兼容。

四、解决方案：依赖降级或源码修改

有两种主要方式解决此问题：

1. 方式一：降级 PyTorch
   将 PyTorch 降级到 nunchaku 支持的版本，例如 1.13.1：

   pip uninstall torch -y
   pip install torch==1.13.1

2. 方式二：修改 nunchaku 的 setup.py
   下载 nunchaku 源码：
   

   git clone https://github.com/nunchaku/nunchaku.git
   cd nunchaku

   修改 setup.py 文件中的依赖版本，将 torch==1.13.1 改为 torch>=1.13.1 或 torch>=2.0.0，然后执行安装：

   pip install -e .

五、Windows 编译工具缺失问题

某些依赖可能需要编译，Windows 上可能缺少必要的构建工具。若安装过程中出现如下错误：

error: Microsoft Visual C++ 14.0 or greater is required.

请下载并安装 Visual C++ Build Tools，确保勾选“C++ build tools”组件。

六、使用 pip 的依赖解析机制

pip 23.0+ 支持新的依赖解析器，可尝试使用以下命令：

pip install --use-feature=fast-deps nunchaku==0.3.0.dev0

或使用 pip-compile 工具（来自 pip-tools）生成兼容的依赖列表：

pip install pip-tools
echo "nunchaku==0.3.0.dev0" > requirements.in
pip-compile

这将生成一个 requirements.txt 文件，其中列出所有兼容版本。

七、使用 Docker 隔离环境（进阶）

如果本地环境难以调试，可以使用 Docker 构建一个干净的环境：

FROM nvidia/cuda:11.8.0-base
RUN apt-get update && apt-get install -y python3-pip
COPY requirements.txt .
RUN pip install -r requirements.txt

其中 requirements.txt 包含如下内容：

torch==2.6.0+cu118
nunchaku @ git+https://github.com/nunchaku/nunchaku.git@main

注意：该方式适用于有容器化部署经验的用户。

八、版本兼容性表格

nunchaku 版本	PyTorch 推荐版本	Python 推荐版本	备注
0.3.0.dev0	1.13.1	3.9	需手动修改依赖或降级 PyTorch
0.2.0	1.12.1	3.8	兼容性较好
0.1.0	1.10.0	3.7	较旧版本，功能有限

九、总结与建议

在 Windows 上安装 nunchaku-0.3.0.dev0 与 PyTorch 2.6 的过程中，主要挑战包括：

• 依赖版本不匹配
• Windows 缺少编译工具
• 第三方库未适配最新 PyTorch

建议优先使用虚拟环境隔离依赖，并通过源码修改或降级 PyTorch 解决冲突。对于复杂项目，推荐使用 Docker 构建统一环境。