Skip to content

Python Notes

Python

Tip

Recommended Python version by SD.Next is python==3.12

SD.Next supports pretty much all current versions of Python, but with some disclaimers:

  • python==3.9 is end-of-life and no longer validated by SD.Next, so compatibility is limited
  • python==3.10 is end-of-support and not recommended
  • python==3.11 is fully supported
  • python==3.12 is fully supported and is the recommended version as most package dependencies come pre-compiled for it
  • python==3.13 is supported, but some packages used by specific features are not available
  • python==3.14 is in early stages of support and marked as experimental

Compile Required

Important

Python 3.13 and 3.14 are not recommended for general use due to limited package compatibility

Python 3.13 and 3.14 require many packages to be built from source which requires additional build tools and much longer installation times
At the very minimum, you will need a C++ compiler toolchain and Python development headers installed on your system

Missing Features

Known missing functionality with python 3.13 and 3.14 includes:

  • insightface no longer maintained and only provides pre-compiled wheels for up to python==3.12,
    so all face swapping features will not work on python==3.13 until a compatible version of insightface is released
  • rembg background removal depends on number of packages that do not provide compatible wheels
  • beta sampling when used with some samplers may fail due to incompatible torchsde package

Backend Compatibility

Compute backends such as torch and onnxruntime also have varying levels of support for different Python versions

  • For cuda and rocm which are under active development,
    support for all python versions is generally good
  • For older and less actively developed backends such as zluda and directml,
    support for newer python versions is often delayed or non-existent