third_party/diffsynth/docs/en/Pipeline_Usage/Setup.md

Installing Dependencies

Install from source (recommended):

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

Install from PyPI (there may be delays in version updates; for latest features, install from source):

pip install diffsynth

GPU/NPU Support

• NVIDIA GPU

Install as described above.

• AMD GPU

You need to install the torch package with ROCm support. Taking ROCm 6.4 (as of the article update date: December 15, 2025) on Linux as an example, run the following command:

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

• Ascend NPU

1. Install CANN through official documentation.

2. Install from source

   git clone https://github.com/modelscope/DiffSynth-Studio.git
   cd DiffSynth-Studio
   # aarch64/ARM
   pip install -e .[npu_aarch64] 
   # x86
   pip install -e .[npu] --extra-index-url "https://download.pytorch.org/whl/cpu"
   

When using Ascend NPU, please replace "cuda" with "npu" in your Python code. For details, see NPU Support.

Other Installation Issues

If you encounter issues during installation, they may be caused by upstream dependencies. Please refer to the documentation for these packages:

• torch
• Ascend/pytorch
• sentencepiece
• cmake