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
- 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
-
Install CANN through official documentation.
-
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.
If you encounter issues during installation, they may be caused by upstream dependencies. Please refer to the documentation for these packages: