Upgrade Python to 3.12

omertuc · omertuc · commit b367557e3265 · 2025-07-01T12:00:18.000+02:00
llama-stack starting with version v0.2.13 requires Python 3.12 or later.
This commit updates the lightspeed-stack codebase and CI workflows to
support only Python 3.12 and above so we can bump the version to
v0.2.13 later
diff --git a/.github/workflows/black.yaml b/.github/workflows/black.yaml
@@ -15,6 +15,6 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          python-version: '3.11'
+          python-version: '3.12'
       - name: Black check
         run: uv tool run black --check .
diff --git a/.github/workflows/check_dependencies.yaml b/.github/workflows/check_dependencies.yaml
@@ -15,7 +15,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          python-version: '3.11'
+          python-version: '3.12'
       - name: Install dependencies
         run: uv sync
       - name: List dependencies
diff --git a/.github/workflows/integration_tests.yaml b/.github/workflows/integration_tests.yaml
@@ -12,7 +12,7 @@ jobs:
       pull-requests: read
     strategy:
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - name: Install uv
diff --git a/.github/workflows/mypy.yaml b/.github/workflows/mypy.yaml
@@ -15,7 +15,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          python-version: '3.11'
+          python-version: '3.12'
       - name: Install dependencies
         run: uv sync
       - name: Python linter
diff --git a/.github/workflows/outdated_dependencies.yaml b/.github/workflows/outdated_dependencies.yaml
@@ -15,7 +15,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          python-version: '3.11'
+          python-version: '3.12'
       - name: Install dependencies
         run: uv sync
       - name: List outdated dependencies
diff --git a/.github/workflows/pydocstyle.yaml b/.github/workflows/pydocstyle.yaml
@@ -15,6 +15,6 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          python-version: '3.11'
+          python-version: '3.12'
       - name: Python linter
         run: uv tool run pydocstyle -v .
diff --git a/.github/workflows/pylint.yaml b/.github/workflows/pylint.yaml
@@ -16,7 +16,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          python-version: '3.11'
+          python-version: '3.12'
       - name: Install dependencies
         run: uv sync
       - name: Python linter
diff --git a/.github/workflows/pyright.yaml b/.github/workflows/pyright.yaml
@@ -16,7 +16,7 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          python-version: '3.11'
+          python-version: '3.12'
       - name: Install dependencies
         run: uv sync
       - name: Run Pyright tests
diff --git a/.github/workflows/ruff.yaml b/.github/workflows/ruff.yaml
@@ -15,6 +15,6 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v5
         with:
-          python-version: '3.11'
+          python-version: '3.12'
       - name: Python linter
         run: uv tool run ruff check . --per-file-ignores=tests/*:S101 --per-file-ignores=scripts/*:S101
diff --git a/.github/workflows/unit_tests.yaml b/.github/workflows/unit_tests.yaml
@@ -12,7 +12,7 @@ jobs:
       pull-requests: read
     strategy:
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
       - name: Install uv
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -37,10 +37,10 @@
 ## Prerequisities
 
 - git
-- Python 3.11, 3.12, or 3.13
+- Python 3.12 or 3.13
 - pip
 
-The development requires at least [Python 3.11](https://docs.python.org/3/whatsnew/3.11.html) due to significant improvement on performance, optimizations which benefit modern ML, AI, LLM, NL stacks, and improved asynchronous processing capabilities. It is also possible to use Python 3.12 or Python 3.13.
+The development requires at least [Python 3.12](https://docs.python.org/3/whatsnew/3.12.html) due to significant improvement on performance, optimizations which benefit modern ML, AI, LLM, NL stacks, and improved asynchronous processing capabilities. It is also possible to use Python 3.13.
 
 
 
diff --git a/Containerfile b/Containerfile
@@ -5,7 +5,7 @@ ARG APP_ROOT=/app-root
 
 # Install Python
 RUN microdnf install -y --nodocs --setopt=keepcache=0 --setopt=tsflags=nodocs \
-    python3.11 python3.11-devel python3.11-pip
+    python3.12 python3.12-devel python3.12-pip
 
 # UV_PYTHON_DOWNLOADS=0 : Disable Python interpreter downloads and use the system interpreter.
 ENV UV_COMPILE_BYTECODE=0 \
@@ -15,7 +15,7 @@ ENV UV_COMPILE_BYTECODE=0 \
 WORKDIR /app-root
 
 # Install uv package manager
-RUN pip3.11 install uv
+RUN pip3.12 install uv
 
 # Add explicit files and directories
 # (avoid accidental inclusion of local directories or env files or credentials)
@@ -51,7 +51,7 @@ ENV PATH="/app-root/.venv/bin:$PATH"
 
 # Run the application
 EXPOSE 8080
-CMD ["python3.11", "src/lightspeed_stack.py"]
+CMD ["python3.12", "src/lightspeed_stack.py"]
 
 LABEL vendor="Red Hat, Inc."
 
diff --git a/README.md b/README.md
@@ -28,9 +28,9 @@ Lightspeed Core Stack (LCS) is an AI powered assistant that provides answers to
 
 # Prerequisities
 
-* Python 3.11, 3.12, or 3.13
+* Python 3.12, or 3.13
     - please note that currently Python 3.14 is not officially supported
-    - all sources are made (backward) compatible with Python 3.11; it is checked on CI
+    - all sources are made (backward) compatible with Python 3.12; it is checked on CI
 
 # Installation
 
diff --git a/docs/installation_linux.md b/docs/installation_linux.md
@@ -3,7 +3,7 @@
 ## Prerequisities
 
 - git
-- Python 3.11 or 3.12
+- Python 3.12 or 3.13
 - pip
 
 ## Installation steps
diff --git a/docs/installation_macos.md b/docs/installation_macos.md
@@ -4,7 +4,7 @@
 
 - brew
 - git
-- Python 3.11 or 3.12
+- Python 3.12 or 3.13
 - pip
 
 ## Installation steps
diff --git a/pdm.lock b/pdm.lock
diff --git a/pyproject.toml b/pyproject.toml
@@ -3,7 +3,7 @@ name = "lightspeed-stack"
 dynamic = ["version"]
 description = "LLM tooling stack"
 authors = []
-requires-python = ">=3.11.1,<=3.13.5"
+requires-python = ">=3.12,<3.14"
 readme = "README.md"
 license = {file = "LICENSE"}
 dependencies = [
diff --git a/uv.lock b/uv.lock
