5

Python

Vladimir Mandic edited this page 2026-06-22 15:40:31 +02:00

Table of Contents

• Python
• Compilation Required
• Missing Features
• Backend Compatibility

Python

Tip

The recommended Python version for SD.Next is python==3.12

SD.Next supports most current Python versions with some caveats:

• python==3.9: End-of-life; compatibility is limited and not validated
• python==3.10: End-of-support; not recommended
• python==3.11: Fully supported
• python==3.12: Fully supported and recommended (most dependencies have pre-compiled wheels)
• python==3.13: Supported, but some packages lack compatible wheels
• python==3.14: Supported experimentally with limited package compatibility

Note

Python experimental versions can be enabled using --experimental flag, but expect potential issues and missing features.
Python version check can be skipped using --ignore flag, but this may lead to installation failures or runtime errors due to incompatible packages.

Compilation Required

Important

Python 3.13 and 3.14 require many packages to be built from source, which requires additional build tools and much longer installation times.

Missing Features

Known missing features with Python 3.13 and 3.14:

• insightface: No longer maintained; only provides pre-compiled wheels up to python==3.12. Face swapping features are unavailable until a compatible version is released.
• rembg: Background removal depends on packages without compatible wheels
• Beta sampling: May fail with some samplers due to incompatible torchsde package

Backend Compatibility

Compute backends like torch and onnxruntime have varying support for different Python versions:

• CUDA and ROCm: Under active development; generally good support for all Python versions
• ZLUDA and DirectML: Older and less actively maintained; support for newer Python versions is often delayed or unavailable

© SD.Next - Check out Docs site