From c0924688d04e3b41399f2cbd8e6050d937bebc06 Mon Sep 17 00:00:00 2001 From: Vladimir Mandic Date: Tue, 17 Feb 2026 22:07:11 +0100 Subject: [PATCH] update wiki Signed-off-by: Vladimir Mandic --- Installation.md | 7 +++---- Python.md | 35 +++++++++++++++++++++++++++++++++++ 2 files changed, 38 insertions(+), 4 deletions(-) create mode 100644 Python.md diff --git a/Installation.md b/Installation.md index 25961ba..db1359d 100644 --- a/Installation.md +++ b/Installation.md @@ -88,10 +88,9 @@ The server is finished launching when the console shows an entry for **"Startup ## Install Python and Git -> [!NOTE] -> SD.Next supports Python versions `3.10.x` up to `3.13.x` -> However, not all compute backends exist on Python `3.13` as they may be based on older `torch` versions -> Recommended version is latest service release of Python `3.12.x` +> [!IMPORTANT] +> Check supported and recommended Python version! +> [Python](Python) ### Windows diff --git a/Python.md b/Python.md new file mode 100644 index 0000000..72d34ba --- /dev/null +++ b/Python.md @@ -0,0 +1,35 @@ +## 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 + +## 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