安装依赖

从源码安装（推荐）：

git clone https://github.com/modelscope/DiffSynth-Studio.git
cd DiffSynth-Studio
pip install -e .

从 pypi 安装（存在版本更新延迟，如需使用最新功能，请从源码安装）

pip install diffsynth

GPU/NPU 支持

NVIDIA GPU

按照以上方式安装即可。

AMD GPU

需安装支持 ROCm 的 torch 包，以 ROCm 6.4（本文更新于 2025 年 12 月 15 日）、Linux 系统为例，请运行以下命令

pip install torch torchvision --index-url https://download.pytorch.org/whl/rocm6.4

Ascend NPU

通过官方文档安装CANN
根据安装依赖安装diffsynth仓

安装torch-npu仓。Ascend NPU 通过 torch-npu 包提供支持，以 2.7.1 版本（本文更新于 2025 年 12 月 15 日）为例，请运行以下命令

# aarch64/ARM 
pip install torch-npu==2.7.1 torchvision==0.22.1
# x86
pip install torch==2.7.1+cpu torchvision==0.22.1+cpu --extra-index-url "https://download.pytorch.org/whl/cpu"
pip install torch-npu==2.7.1

使用 Ascend NPU 时，请将 Python 代码中的 "cuda" 改为 "npu"，详见NPU 支持。

其他安装问题

如果在安装过程中遇到问题，可能是由上游依赖包导致的，请参考这些包的文档：

1.7 KiB Raw Blame History Unescape Escape

安装依赖

GPU/NPU 支持

其他安装问题

1.7 KiB

Raw Blame History