Python Notes

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

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.

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

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