From bc24f6d018cb3e5078612765c5072b2e4a0d3e0d Mon Sep 17 00:00:00 2001
From: Jens Tirsvad Nielsen <jenstirsvad@gmail.com>
Date: Tue, 13 Oct 2026 17:03:15 +0800
Subject: [PATCH] Document Python 3.13 on Debian 12: the apt python3 is 3.11

No issue closed: documentation fix found while verifying the Debian commands.
---
 .gitignore         |  1 +
 README.md          | 17 +++++++++++++++++
 wiki/Install.da.md | 15 +++++++++++++++
 wiki/Install.md    | 15 +++++++++++++++
 wiki/Install.ms.md | 15 +++++++++++++++
 5 files changed, 63 insertions(+)

diff --git a/.gitignore b/.gitignore
index 6bef812..3710a4b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,6 +6,7 @@ __pycache__/
 
 # Virtual environments
 .venv/
+.uvenv/
 venv/
 env/
 
diff --git a/README.md b/README.md
index b5865ec..bd62589 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,8 @@ If PowerShell refuses to run the activation script, allow it for the current ses
 
 ### Linux debian
 
+On Debian 13 (trixie) or later, `python3` is 3.13:
+
 ```bash
 sudo apt install python3 python3-venv
 python3 -m venv .venv
@@ -44,6 +46,20 @@ python -m pip install --upgrade pip
 python -m pip install -e ".[dev]"
 ```
 
+On Debian 12 (bookworm), `python3` is 3.11 and `pip` refuses to install the project
+(`requires a different Python`). Get Python 3.13 with [uv][uv] and use it for the `.venv`:
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .uvenv
+.uvenv/bin/python -m pip install uv
+.uvenv/bin/uv python install 3.13
+.uvenv/bin/uv venv --seed --python 3.13 .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
 ### MacOS
 
 ```bash
@@ -132,6 +148,7 @@ GNU Affero General Public License v3.0 or later. See [LICENSE][license].
 [img-run]: docs/images/run.png
 [img-tests]: docs/images/tests.png
 [doxygen]: https://www.doxygen.nl/
+[uv]: https://docs.astral.sh/uv/
 [adr-0001]: docs/adr/adr-0001-standard-library-instead-of-pandas.md
 [ci]: .gitea/workflows/ci.yml
 [doxyfile]: Doxyfile
diff --git a/wiki/Install.da.md b/wiki/Install.da.md
index bbe1124..757a5bc 100644
--- a/wiki/Install.da.md
+++ b/wiki/Install.da.md
@@ -15,6 +15,8 @@ python -m pip install -e ".[dev]"
 
 ## Linux Debian
 
+På Debian 13 (trixie) eller nyere er `python3` 3.13:
+
 ```bash
 sudo apt install python3 python3-venv
 python3 -m venv .venv
@@ -23,6 +25,19 @@ python -m pip install --upgrade pip
 python -m pip install -e ".[dev]"
 ```
 
+På Debian 12 (bookworm) er `python3` 3.11, og `pip` nægter at installere projektet (`requires a different Python`). Hent Python 3.13 med [uv](https://docs.astral.sh/uv/) og brug den til `.venv`:
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .uvenv
+.uvenv/bin/python -m pip install uv
+.uvenv/bin/uv python install 3.13
+.uvenv/bin/uv venv --seed --python 3.13 .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
 ## macOS
 
 ```bash
diff --git a/wiki/Install.md b/wiki/Install.md
index d8c418b..e2cd9b3 100644
--- a/wiki/Install.md
+++ b/wiki/Install.md
@@ -15,6 +15,8 @@ python -m pip install -e ".[dev]"
 
 ## Linux Debian
 
+On Debian 13 (trixie) or later, `python3` is 3.13:
+
 ```bash
 sudo apt install python3 python3-venv
 python3 -m venv .venv
@@ -23,6 +25,19 @@ python -m pip install --upgrade pip
 python -m pip install -e ".[dev]"
 ```
 
+On Debian 12 (bookworm), `python3` is 3.11 and `pip` refuses to install the project (`requires a different Python`). Get Python 3.13 with [uv](https://docs.astral.sh/uv/) and use it for the `.venv`:
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .uvenv
+.uvenv/bin/python -m pip install uv
+.uvenv/bin/uv python install 3.13
+.uvenv/bin/uv venv --seed --python 3.13 .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
 ## macOS
 
 ```bash
diff --git a/wiki/Install.ms.md b/wiki/Install.ms.md
index ee54e37..7b31080 100644
--- a/wiki/Install.ms.md
+++ b/wiki/Install.ms.md
@@ -15,6 +15,8 @@ python -m pip install -e ".[dev]"
 
 ## Linux Debian
 
+Pada Debian 13 (trixie) atau lebih baharu, `python3` ialah 3.13:
+
 ```bash
 sudo apt install python3 python3-venv
 python3 -m venv .venv
@@ -23,6 +25,19 @@ python -m pip install --upgrade pip
 python -m pip install -e ".[dev]"
 ```
 
+Pada Debian 12 (bookworm), `python3` ialah 3.11 dan `pip` enggan memasang projek (`requires a different Python`). Dapatkan Python 3.13 dengan [uv](https://docs.astral.sh/uv/) dan gunakannya untuk `.venv`:
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .uvenv
+.uvenv/bin/python -m pip install uv
+.uvenv/bin/uv python install 3.13
+.uvenv/bin/uv venv --seed --python 3.13 .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
 ## macOS
 
 ```bash
-- 
2.54.0