bumped min python version to 3.10 (#2913)

jakubchlapek · dennisbader · web-flow · commit d1d4bbbf670d · 2025-10-03T09:43:07.000+02:00
* bumped min python version to 3.10

* changelog update

* update docker imaged and others

---------

Co-authored-by: dennisbader &lt;dennis.bader@gmx.ch&gt;
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -17,8 +17,8 @@ Steps to reproduce the behavior, preferably code snippet.
 A clear and concise description of what you expected to happen.
 
 **System (please complete the following information):**
- - Python version: [e.g. 3.10]
- - darts version [e.g. 0.31.0]
+ - Python version: [e.g. 3.11]
+ - darts version [e.g. 0.38.0]
 
 **Additional context**
 Add any other context about the problem here.
diff --git a/.github/workflows/develop.yml b/.github/workflows/develop.yml
@@ -12,10 +12,10 @@ jobs:
       - name: "Clone repository"
         uses: actions/checkout@v4
 
-      - name: "Set up Python 3.10"
+      - name: "Set up Python 3.11"
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       - name: "Install Dev Dependencies"
         run: |
@@ -32,7 +32,7 @@ jobs:
     strategy:
       matrix:
         os: [macos-14, ubuntu-latest]
-        python-version: ['3.10']
+        python-version: ['3.11']
         flavour: ['all']
 
     steps:
@@ -92,10 +92,10 @@ jobs:
       - name: "Clone repository"
         uses: actions/checkout@v4
 
-      - name: "Set up Python 3.10"
+      - name: "Set up Python 3.11"
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       # use `uv` to retrieve the latest dependency versions
       - name: "Compile Dependency Versions"
@@ -146,10 +146,10 @@ jobs:
       - name: "Clone repository"
         uses: actions/checkout@v4
 
-      - name: "Set up Python 3.10"
+      - name: "Set up Python 3.11"
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       # use `uv` to retrieve the latest dependency versions
       - name: "Compile Dependency Versions"
diff --git a/.github/workflows/doc.yml b/.github/workflows/doc.yml
@@ -10,10 +10,10 @@ jobs:
       - name: "Clone repository"
         uses: actions/checkout@v4
 
-      - name: "Set up Python 3.10"
+      - name: "Set up Python 3.11"
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       # use `uv` to retrieve the latest dependency versions
       - name: "Compile Dependency Versions"
diff --git a/.github/workflows/merge.yml b/.github/workflows/merge.yml
@@ -12,10 +12,10 @@ jobs:
       - name: "Clone repository"
         uses: actions/checkout@v4
 
-      - name: "Set up Python 3.11"
+      - name: "Set up Python 3.12"
         uses: actions/setup-python@v5
         with:
-          python-version: '3.11'
+          python-version: '3.12'
 
       - name: "Install Dev Dependencies"
         run: |
@@ -31,7 +31,7 @@ jobs:
     strategy:
       matrix:
         os: [macos-14, ubuntu-latest]
-        python-version: ['3.9', '3.11']
+        python-version: ['3.10', '3.12']
         flavour: ['core', 'torch', 'all']
 
     steps:
@@ -90,10 +90,10 @@ jobs:
       - name: "Clone repository"
         uses: actions/checkout@v4
 
-      - name: "Set up Python 3.10"
+      - name: "Set up Python 3.11"
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       # use `uv` to retrieve the latest dependency versions
       - name: "Compile Dependency Versions"
@@ -138,10 +138,10 @@ jobs:
       - name: "Clone repository"
         uses: actions/checkout@v4
 
-      - name: "Set up Python 3.10"
+      - name: "Set up Python 3.11"
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       # use `uv` to retrieve the latest dependency versions
       - name: "Compile Dependency Versions"
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -17,10 +17,10 @@ jobs:
           token: ${{ secrets.RELEASE_WORKFLOW_TOKEN_NEW_FINE_GRAINED }}
           fetch-depth: '1'
 
-      - name: "2. Set up Python 3.10"
+      - name: "2. Set up Python 3.11"
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       - name: "Setup Pip"
         run: |
@@ -108,10 +108,10 @@ jobs:
       - name: "Clone repository"
         uses: actions/checkout@v4
 
-      - name: "Set up Python 3.10"
+      - name: "Set up Python 3.11"
         uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
+          python-version: '3.11'
 
       # use `uv` to retrieve the latest dependency versions
       - name: "Compile Dependency Versions"
diff --git a/.github/workflows/update-cache.yml b/.github/workflows/update-cache.yml
@@ -12,7 +12,7 @@ jobs:
     strategy:
       matrix:
         os: [macos-14, ubuntu-latest]
-        python-version: ['3.10']
+        python-version: ['3.11']
         flavour: ['all']
 
     steps:
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -34,8 +34,10 @@ but cannot always guarantee backwards compatibility. Changes that may **break co
 
 **Dependencies**
 
-- We raised the minimum pytorch-lightning version to `pytorch-lightning>=2.0.0`. [#2888](https://github.com/unit8co/darts/pull/2888) by [Dennis Bader](https://github.com/dennisbader).
+- 🔴 Removed support for Python 3.9. The new minimum Python version is 3.10. [#2913](https://github.com/unit8co/darts/pull/2913) by [Jakub Chłapek](https://github.com/jakubchlapek)
 - We made the Darts core and `torch` packages lighter by removing XGBoost and StatsForecast from the dependencies. All our forecasting models wrapping around these libraries will still be supported. To use them simply install the packages manually or via `u8darts[notorch]` and `u8darts[all]`. [#2906](https://github.com/unit8co/darts/pull/2906) by [Jakub Chłapek](https://github.com/jakubchlapek)
+- We raised the minimum pytorch-lightning version to `pytorch-lightning>=2.0.0`. [#2888](https://github.com/unit8co/darts/pull/2888) by [Dennis Bader](https://github.com/dennisbader).
+- Bumped the Python version of the Darts Docker image from 3.9 to 3.12. [#2913](https://github.com/unit8co/darts/pull/2913) by [Jakub Chłapek](https://github.com/jakubchlapek)
 
 ### For developers of the library:
 
diff --git a/Dockerfile b/Dockerfile
@@ -1,5 +1,5 @@
 # Use a specific Python version for better reproducibility
-FROM python:3.10
+FROM python:3.12
 
 # Set work directory
 WORKDIR /app
@@ -14,9 +14,8 @@ RUN pip install --no-cache-dir -r /app/requirements/dev-all.txt
 COPY setup.py pyproject.toml MANIFEST.in README.md /app/
 COPY darts/ /app/darts/
 
-# Install darts in development mode
+# Install darts in development mode and clean up pip cache
 RUN pip install --no-cache-dir -e . && \
-    # Clean up pip cache
     rm -rf ~/.cache/pip
 
 # Copy examples
diff --git a/INSTALL.md b/INSTALL.md
@@ -17,10 +17,10 @@ we also maintain the `u8darts` package, which provides the following alternate l
 * Install core + neural networks (PyTorch): `pip install "u8darts[torch]"` (equivalent to `pip install darts`)
 
 ## From conda-forge
-Create a conda environment (e.g., for Python 3.10):
+Create a conda environment (e.g., for Python 3.11):
 (after installing [conda](https://docs.conda.io/en/latest/miniconda.html)):
 
-    conda create --name <env-name> python=3.10
+    conda create --name <env-name> python=3.11
 
 Activate the environment
 
diff --git a/README.md b/README.md
@@ -5,7 +5,7 @@
 ---
 [![PyPI version](https://badge.fury.io/py/u8darts.svg)](https://badge.fury.io/py/darts)
 [![Conda Version](https://img.shields.io/conda/vn/conda-forge/u8darts-all.svg)](https://anaconda.org/conda-forge/u8darts-all)
-![Supported versions](https://img.shields.io/badge/python-3.9+-blue.svg)
+![Supported versions](https://img.shields.io/badge/python-3.10+-blue.svg)
 [![Docker Image Version (latest by date)](https://img.shields.io/docker/v/unit8/darts?label=docker&sort=date)](https://hub.docker.com/r/unit8/darts)
 ![GitHub Release Date](https://img.shields.io/github/release-date/unit8co/darts)
 ![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/unit8co/darts/release.yml?branch=master)
@@ -50,7 +50,7 @@ fledged anomaly detection models.
 
 ## Quick Install
 
-We recommend to first setup a clean Python environment for your project with Python 3.9+ using your favorite tool
+We recommend to first setup a clean Python environment for your project with Python 3.10+ using your favorite tool
 ([conda](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html "conda-env"),
 [venv](https://docs.python.org/3/library/venv.html), [virtualenv](https://virtualenv.pypa.io/en/latest/) with
 or without [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/)).
diff --git a/conda_recipe/environment.yml b/conda_recipe/environment.yml
@@ -1,6 +1,6 @@
 # conda-specific dependencies for the dev environment
 name: darts-dev
 dependencies:
-  - python>=3.9
+  - python>=3.10
   - conda-build
   - conda-verify
diff --git a/setup.py b/setup.py
@@ -45,7 +45,7 @@ def read_requirements(path):
         "darts": ["py.typed"],
     },
     zip_safe=False,
-    python_requires=">=3.9",
+    python_requires=">=3.10",
     classifiers=[
         "Intended Audience :: Science/Research",
         "Intended Audience :: Developers",
@@ -57,9 +57,9 @@ def read_requirements(path):
         "Operating System :: Unix",
         "Operating System :: MacOS",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
         "Programming Language :: Python :: Implementation :: PyPy",
     ],
     keywords="time series forecasting",
diff --git a/setup_u8darts.py b/setup_u8darts.py
@@ -45,7 +45,7 @@ def read_requirements(path):
         "darts": ["py.typed"],
     },
     zip_safe=False,
-    python_requires=">=3.9",
+    python_requires=">=3.10",
     classifiers=[
         "Intended Audience :: Science/Research",
         "Intended Audience :: Developers",
@@ -57,9 +57,9 @@ def read_requirements(path):
         "Operating System :: Unix",
         "Operating System :: MacOS",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
         "Programming Language :: Python :: Implementation :: PyPy",
     ],
     keywords="time series forecasting",
