Add Python 3.15 to Python packaging by dannyota · Pull Request #33359 · microsoft/onnxruntime

Danny On The Air (dannyota) · 2026-10-14T05:47:42Z

Description

Add CPython 3.15 to the Python packaging pipelines, following #26397 for 3.14.

CPU: Windows x64 and arm64, macOS arm64, and cp315 in the Linux packaging interpreter list.
CUDA 12 and 13: Windows x64 and Linux x86_64, plus Linux aarch64 for CUDA 13. Windows GPU tests run on 3.15.
setup.py classifier and the package smoke test.
NumPy 2.5.4 on 3.15, since 2.4.2 has no cp315 wheel.
torch, torchvision, triton, sentencepiece and h5py have no cp315 wheels. They, and neural-compressor (its tests need torch), are limited to Python < 3.15, and build.py skips torch-dependent tests on 3.15.

Not included: cp315t and a GitHub Actions CI job.

Testing

Fork workflow: CPU wheel built and tested for 3.14 and 3.15 on Linux x64, Windows x64 and macOS arm64. 128 passed, 4 WebGPU skips per job. https://github.com/dannyota/onnxruntime/actions/runs/38506082187
The Linux cp315 wheel ran on an Intel Arc GPU through the WebGPU plugin EP.
After rebasing on main, the tools/ci_build packaging tests (test_build_linux_python_package, test_build_python_tests, test_python_packaging) pass on Linux x64 and Linux arm64.
Changed requirements files resolve on Python 3.11, 3.14 and 3.15. PyYAML has no cp315 wheel yet and builds from sdist.
CUDA on 3.15 is not tested here (no NVIDIA hardware); it relies on the packaging pipeline.

Maintainer action

Packaging images need CPython 3.15 at /opt/python/cp315-cp315. Without it, Linux CPU packaging skips 3.15 and the 3.15 Linux GPU jobs fail.

Motivation and Context

Python 3.15.0 is released, and #33271 requests cp315 wheels.

azure-pipelines · 2026-10-14T05:47:52Z

Azure Pipelines: There may be pipelines that require an authorized user to comment /azp run to run.

Copilot

🟡 Changes recommended

The three new CI-build test modules are not registered with any automated test target.

3 open findings

Register selector validation tests with CI · New
Register Python 3.15 dispatch tests with CI · New
Register packaging tests with CI or test discovery · New

What changed in this PR

Adds CPython 3.15 wheel packaging across supported CPU and CUDA platforms, with compatible dependency pins and test gating.

Changes:

Extends packaging matrices, classifiers, and smoke tests for Python 3.15.
Uses NumPy 2.5.4 and excludes dependencies lacking cp315 wheels.
Skips PyTorch-dependent tests and improves packaging-script validation.

File	Description
`tools/ci_build/test_python_packaging.py`	Tests packaging configuration.
`tools/ci_build/test_build_python_tests.py`	Tests Python test dispatch.
`tools/ci_build/test_build_linux_python_package.py`	Tests Linux packaging scripts.
`tools/ci_build/requirements/transformers-test/requirements.txt`	Adds cp315 dependency markers.
`tools/ci_build/github/windows/python/requirements.txt`	Pins cp315-compatible NumPy.
`tools/ci_build/github/linux/python/requirements.txt`	Pins cp315-compatible NumPy.
`tools/ci_build/github/linux/docker/scripts/requirements.txt`	Updates NumPy selection.
`tools/ci_build/github/linux/docker/scripts/manylinux/requirements.txt`	Gates unsupported cp315 packages.
`tools/ci_build/github/linux/docker/scripts/lort/requirements.txt`	Gates h5py and updates NumPy.
`tools/ci_build/github/linux/docker/inference/aarch64/python/cpu/scripts/requirements.txt`	Updates aarch64 NumPy pin.
`tools/ci_build/github/linux/build_linux_python_package.sh`	Adds cp315 and selector validation.
`tools/ci_build/github/azure-pipelines/templates/set-python-manylinux-variables-step.yml`	Maps Python 3.15 manylinux path.
`tools/ci_build/github/azure-pipelines/templates/py-win-cpu.yml`	Adds Windows CPU cp315 jobs.
`tools/ci_build/github/azure-pipelines/templates/py-package-smoking-test.yml`	Adds cp315 smoke testing.
`tools/ci_build/github/azure-pipelines/stages/py-gpu-packaging-stage.yml`	Adds Windows/Linux GPU cp315 builds.
`tools/ci_build/github/azure-pipelines/stages/py-cpu-packaging-stage.yml`	Adds macOS cp315 build.
`tools/ci_build/github/azure-pipelines/py-cuda13-packaging-pipeline.yml`	Adds CUDA 13 aarch64 cp315.
`tools/ci_build/github/azure-pipelines/py-cuda-package-test-pipeline.yml`	Downloads Windows cp315 GPU wheel.
`tools/ci_build/build.py`	Gates PyTorch-dependent tests.
`setup.py`	Adds Python 3.15 classifier.
`requirements-materialize-onnx-node-tests.txt`	Aligns NumPy pins.
`onnxruntime/test/python/quantization/test_op_matmulnbits_prepacked_cuda.py`	Skips PyTorch parity on cp315.
`onnxruntime/test/python/onnxruntime_test_python_symlink_data.py`	Releases sessions before cleanup.
`cmake/onnxruntime_unittests.cmake`	Selects expected cp315 NumPy version.

🧠 Review effort: Balanced

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Tianlei Wu (tianleiwu) · 2026-10-14T05:54:03Z

Thank Danny On The Air (@dannyota), we will add /opt/python/cp315-cp315 to manylinux docker images.
Please be patient.

Signed-off-by: Danny <dannyontheair@outlook.com>

…ests Select NumPy 2.5.4 on Python 3.15 in the remaining CI requirement files. Limit triton, torch, torchvision, sentencepiece and h5py to Python < 3.15, because they publish no cp315 wheels. Limit neural-compressor the same way, because the optional tests that use it also need torch. Skip both PyTorch installs in build.py and the PyTorch packer parity test on Python 3.15, and keep the other Python tests running. Signed-off-by: Danny <dannyontheair@outlook.com>

Build Python 3.15 wheels in the Windows x64, Windows arm64 and macOS arm64 CPU packaging jobs, replacing the opt-in parameter. Add cp315 to the default Linux packaging interpreters before cp312, which stays last. A default build skips a missing interpreter with a warning, as it does for the other versions; an explicit -p selection still fails. Signed-off-by: Danny <dannyontheair@outlook.com>

Build Python 3.15 CUDA 12 and CUDA 13 wheels for Windows x64 and Linux x86_64, and Linux aarch64 for CUDA 13. Run the Windows GPU test stage on 3.15 like the other versions, and add the 3.15 wheel to the CUDA package test pipeline. Add Python 3.15 to the package classifiers and to the package smoke-test matrix. Signed-off-by: Danny <dannyontheair@outlook.com>

Danny On The Air (dannyota) · 2026-11-09T13:57:26Z

Hi Tianlei Wu (@tianleiwu) eserscor, rebased on main. Did the Nov 5 image refresh (#33777) add /opt/python/cp315-cp315? If so, could you approve the workflows and queue the packaging pipelines? Lots of folks in #33271 are waiting on cp315 wheels. Thanks!

Copilot AI balanced review requested due to automatic review settings October 14, 2026 05:47

Copilot started reviewing on behalf of Danny On The Air (dannyota) October 14, 2026 05:48

View session

Copilot AI reviewed Oct 14, 2026

View reviewed changes

Comment thread tools/ci_build/test_build_linux_python_package.py Resolved

Comment thread tools/ci_build/test_build_python_tests.py Resolved

Comment thread tools/ci_build/test_python_packaging.py Resolved

Alex-James-Smith mentioned this pull request Oct 27, 2026

[Feature Request] Python 3.15 wheels (cp315) #33271

Open

This was referenced Oct 28, 2026

Run CI tool jobs on Python 3.15, type-check CrewAI and Weaviate on 3.14 open-telemetry/opentelemetry-python-genai#996

Merged

Drop Python 3.10 and add Python 3.15 support open-telemetry/opentelemetry-python-genai#992

Merged

This was referenced Oct 29, 2026

build: run radio on Python 3.14 until onnxruntime ships cp315 wheels those-who-run/radio#13

Merged

feat(radio): Piper synthesis, sentence by sentence, with a clip cache and the voice settings those-who-run/radio#14

Merged

Glenn Jocher (glenn-jocher) mentioned this pull request Oct 31, 2026

ultralytics 8.4.195 Add Python 3.15 CI and classifier ultralytics/ultralytics#26975

Merged

Adam Fourney (afourney) mentioned this pull request Nov 6, 2026

Include Python 3.15 in package metadata and CI microsoft/markitdown#2844

Draft

Mohab Mohie (MohabMohie) mentioned this pull request Nov 7, 2026

Upgrade managed project Python to 3.15 (blocked on onnxruntime cp315 wheels) ShaftHQ/SHAFT_ENGINE#7751

Open

Danny On The Air (dannyota) added 5 commits November 9, 2026 19:26

Prepare CPU packaging for Python 3.15

cc4ea7a

Signed-off-by: Danny <dannyontheair@outlook.com>

Release sessions before deleting symlink test data

f40bba5

Signed-off-by: Danny <dannyontheair@outlook.com>

Danny On The Air (dannyota) force-pushed the python/315 branch from db4ae5c to ea3fa8c Compare November 9, 2026 13:07

Navigation Menu

Repository navigation

Add Python 3.15 to Python packaging - #33359

Add Python 3.15 to Python packaging#33359
Danny On The Air (dannyota) wants to merge 5 commits into
microsoft:mainfrom
dannyota:python/315

Danny On The Air (dannyota) commented Oct 14, 2026 •

edited

Loading

Uh oh!

azure-pipelines Bot commented Oct 14, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Tianlei Wu (tianleiwu) commented Oct 14, 2026

Uh oh!

Danny On The Air (dannyota) commented Nov 9, 2026

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

Danny On The Air (dannyota) commented Oct 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Motivation and Context

Uh oh!

azure-pipelines Bot commented Oct 14, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Tianlei Wu (tianleiwu) commented Oct 14, 2026

Uh oh!

Danny On The Air (dannyota) commented Nov 9, 2026

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Danny On The Air (dannyota) commented Oct 14, 2026 •

edited

Loading