Skip to content

Python: Support Python 3.15 in the standard package set #9362

Description

Problem

Python 3.15 is now stable, but the published Python packages do not advertise it as supported and the standard agent-framework install has not been validated and documented against the final interpreter. Some integrations also have upstream dependency gaps that change what the meta-package can provide on Python 3.15.

Use Case and Evidence

Users should be able to adopt Python 3.15 while continuing to install the released agent-framework meta-package. A dependency audit covered 97 direct external dependencies, a stable-only pip installation of the complete meta-package succeeded on CPython 3.15.0, and the supported workspace completed its test sweep with only known timing flakes reproduced on Python 3.14. The audit also identified explicit limitations in Power Fx, RedisVL, Hyperlight, the AG-UI A2UI extra, DuckDB, and Lab dependencies.

Desired Outcome

Release agent-framework and agent-framework-core metadata that explicitly supports Python 3.15, exercise the final interpreter in CI, keep unsupported integrations out of the Python 3.15 standard install, and clearly document the remaining feature limitations in the published README and package-specific documentation.

Alternatives Considered

  • Wait until every optional and separately installed integration supports Python 3.15. This unnecessarily blocks the standard package set.
  • Advertise blanket Python 3.15 support without exceptions. This would be misleading because Power Fx expressions and several native integrations remain unavailable.
  • Continue allowing installation through the open-ended Requires-Python range without an explicit classifier or CI coverage. This leaves users without a supported compatibility statement.

Proposed Direction

  • Add Python 3.15 classifiers to the compatible published distributions.
  • Test the supported workspace and meta-package installation on CPython 3.15 final.
  • Preserve Python-version markers that omit Redis and Hyperlight from agent-framework-core[all] on 3.15.
  • Update SQL Server to mssql-python>=1.16.0, which publishes Python 3.15 wheels.
  • Upgrade uv and related build/tooling pins required for Python 3.15.
  • Document concrete meta-package limitations and package-specific upstream blockers.
  • Refresh currently open Python frontend Dependabot updates and compatible Python tooling releases in the same compatibility pass.

Scope and Non-Goals

This issue does not claim Python 3.15 support for non-meta packages whose upstream dependencies remain unsupported. It does not make Power Fx expressions work on Python 3.14+ and does not replace the upstream issues tracking RedisVL, A2UI, Hyperlight, DuckDB, PyArrow, DeepDiff, or Power Fx support.

Language

Python

Contribution Intent

I am willing to implement this

Acknowledgements

  • I searched existing issues and did not find a duplicate.
  • I will wait for explicit maintainer agreement before starting implementation of a non-trivial change.

Metadata

Metadata

Assignees

No one assigned

    Labels

    dependenciesUsage: [Issues, PRs], Target: dependencies in the projectpythonUsage: [Issues, PRs], Target: Pythonready-for-implementationMaintainers agree the problem and direction are ready for implementation.

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions