Switch to Python 3.13 (#2163)

* Switch to Python 3.13

* Update CHANGELOG.md

* Update README.md

Author: mathbunnyru

CHANGELOG.md

@@ -3,6 +3,12 @@
 This changelog only contains breaking and/or significant changes manually introduced to this repository (using Pull Requests).
 All image manifests can be found in [the wiki](https://github.com/jupyter/docker-stacks/wiki).
 
+## 2025-08-15
+
+Affected: all images.
+
+- **Breaking:** `docker-stacks-foundation`: switch to Python 3.13 ([#2163](https://github.com/jupyter/docker-stacks/pull/2163)).
+
 ## 2025-04-13
 
 Affected: `tensorflow-notebook`.

Makefile

@@ -38,7 +38,7 @@ help:
 # Note that `ROOT_IMAGE` and `PYTHON_VERSION` arguments are only applicable to the `docker-stacks-foundation` image
 build/%: DOCKER_BUILD_ARGS?=
 build/%: ROOT_IMAGE?=ubuntu:24.04
-build/%: PYTHON_VERSION?=3.12
+build/%: PYTHON_VERSION?=3.13
 build/%: ## build the latest image for a stack using the system's architecture
 	docker build $(DOCKER_BUILD_ARGS) --rm --force-rm \
 	  --tag "$(REGISTRY)/$(OWNER)/$(notdir $@)" \

README.md

@@ -123,7 +123,8 @@ If you want to use the older `Ubuntu` and/or `Python` version, you can use the f
 | 2023-05-30   | 22.04  | 3.10   | `4d70cf8da953` |
 | 2024-08-26   | 22.04  | 3.11   | `00987883e58d` |
 | 2024-10-22   | 24.04  | 3.11   | `b74418220768` |
-| weekly build | 24.04  | 3.12   | `latest`       |
+| 2025-08-11   | 24.04  | 3.12   | `82d322f00937` |
+| weekly build | 24.04  | 3.13   | `latest`       |
 
 ## Contributing
 

images/docker-stacks-foundation/Dockerfile

@@ -95,7 +95,7 @@ RUN rm -rf "/home/${NB_USER}/.cache/"
 USER ${NB_UID}
 
 # Pin the Python version here, or set it to "default"
-ARG PYTHON_VERSION=3.12
+ARG PYTHON_VERSION=3.13
 
 # Setup work directory for backward-compatibility
 RUN mkdir "/home/${NB_USER}/work" && \

tests/by_image/docker-stacks-foundation/test_python_version.py

@@ -5,7 +5,7 @@
 from tests.utils.tracked_container import TrackedContainer
 
 LOGGER = logging.getLogger(__name__)
-EXPECTED_PYTHON_VERSION = "3.12"
+EXPECTED_PYTHON_VERSION = "3.13"
 
 
 def test_python_version(container: TrackedContainer) -> None: