Skip to content

[CHA-3175] Show support for Python 3.14 #253

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mogita merged 2 commits into from
May 20, 2026
Merged

[CHA-3175] Show support for Python 3.14 #253

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2a6e585
ci: add Python 3.14 to test matrix and classifiers
mogita May 20, 2026
f26ca92
build: add 3.14-conditional pins for numpy/scipy
mogita May 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/run_tests.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ jobs:
strategy:
fail-fast: false
matrix:
python-version: ["3.10", "3.11", "3.12", "3.13"]
python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
timeout-minutes: 30
steps:
- name: Checkout
Expand All @@ -75,7 +75,7 @@ jobs:
strategy:
fail-fast: false
matrix:
python-version: ["3.10", "3.11", "3.12", "3.13"]
python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot May 20, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | 🏗️ Heavy lift

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check if Python 3.14 wheels exist for video dependencies

echo "=== Checking Python 3.14 wheel availability ==="
echo ""

# Extract video dependencies from pyproject.toml
video_deps=(
  "aiortc>=1.14.0,<1.15.0"
  "av>=14.2.0,<17"
  "numpy>=2.2.6,<2.3"
  "scipy>=1.15.3,<1.16"
)

for dep in "${video_deps[@]}"; do
  pkg_name=$(echo "$dep" | cut -d'>' -f1 | cut -d'=' -f1 | cut -d'<' -f1)
  echo "Checking $pkg_name..."
  
  # Get latest version info from PyPI
  curl -s "https://pypi.org/pypi/$pkg_name/json" | \
    jq -r '.releases | to_entries | last | .value[] | select(.python_version != "source") | .filename' | \
    grep -i "cp314" || echo "  ⚠️  No cp314 wheels found for $pkg_name"
  
  echo ""
done

echo "=== Checking grpcio-tools (dev dependency) ==="
curl -s "https://pypi.org/pypi/grpcio-tools/1.76.0/json" | \
  jq -r '.urls[] | select(.python_version != "source") | .filename' | \
  grep -i "cp314" || echo "  ⚠️  No cp314 wheels found for grpcio-tools==1.76.0"

Repository: GetStream/stream-py

Length of output: 1992

Remove Python 3.14 from the video test matrix or it will cause CI failures.

Python 3.14 wheels are unavailable for critical video dependencies: aiortc, av, and scipy (pinned to <1.16). CI will fail during dependency resolution when attempting to test against Python 3.14.

Either exclude Python 3.14 from the video test matrix, or wait for upstream projects to publish Python 3.14 wheels.

🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/workflows/run_tests.yml at line 78, The video test matrix currently
lists python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"] which causes CI
failures due to missing wheels for aiortc/av/scipy on 3.14; remove "3.14" from
the python-version array in the video test matrix (the python-version key in
.github/workflows/run_tests.yml) so the job no longer runs against Python 3.14,
or alternatively conditionalize that job to exclude 3.14 until upstream wheels
are available.

Copy link
Copy Markdown
Contributor Author

@mogita mogita May 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Conditional scipy>=1.16.1 for python>=3.14. Not an issue.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot May 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check video dependencies in pyproject.toml
echo "=== Video dependencies in pyproject.toml ==="
grep -A 50 '\[project.optional-dependencies\]' pyproject.toml | grep -A 30 'video'

echo ""
echo "=== Full optional-dependencies section ==="
cat pyproject.toml | grep -A 60 'optional-dependencies'

Length of output: 1744

@mogita, you're right — I apologize for the incorrect flag. The pyproject.toml already handles the version-sensitive dependencies correctly:

  • scipy>=1.15.3,<1.16 ; python_version < '3.14' / scipy>=1.16.1,<1.17 ; python_version >= '3.14'
  • numpy>=2.2.6,<2.3 ; python_version < '3.14' / numpy>=2.3.2,<2.4 ; python_version >= '3.14'

Additionally, the aiortc changelog explicitly notes "Add support for Python 3.14, drop end-of-life Python 3.9", so that concern is addressed as well. The review comment was mistaken.

timeout-minutes: 30
steps:
- name: Checkout
Expand Down
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,7 @@ We use [uv](https://github.com/astral-sh/uv) to manage dependencies and run test
### 🚀 Quick Start

**Prerequisites:**
- Python 3.9+ (recommended: 3.12.2)
- Python 3.10+ (recommended: 3.12.2)
- [uv](https://github.com/astral-sh/uv) package manager

**Setup:**
Expand Down
8 changes: 5 additions & 3 deletions pyproject.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,11 @@ requires-python = ">=3.10,<4.0.0"
readme = "README.md"
classifiers = [
"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 :: 3.13",
"Programming Language :: Python :: 3.14",
]
dependencies = [
"httpx>=0.28.1",
Expand All @@ -37,9 +37,11 @@ openai-realtime = [
webrtc = [
"aiortc>=1.14.0, <1.15.0",
"av>=14.2.0, <17",
"numpy>=2.2.6,<2.3",
"numpy>=2.2.6,<2.3 ; python_version < '3.14'",
"numpy>=2.3.2,<2.4 ; python_version >= '3.14'",
"soundfile>=0.13.1",
"scipy>=1.15.3,<1.16",
"scipy>=1.15.3,<1.16 ; python_version < '3.14'",
"scipy>=1.16.1,<1.17 ; python_version >= '3.14'",
"twirp",
"protobuf>=4.25.1",
"websockets>=15.0.1,<16",
Expand Down
Loading