Skip to content

Conversation

@edmorley
Copy link
Member

@edmorley edmorley commented Dec 4, 2025

Previously if a new app did not specify a Python version (e.g. via a .python-version file), then the buildpack would default to the latest Python 3.13 release.

Now the buildpack will use the latest Python 3.14 release.

This does not affect:

  • apps that specify an explicit Python version
  • existing apps that have already had a build using the previous default version (since that version is remembered from one build to the next, via the "version pinning" / "sticky versions" feature).

Use-cases involving new apps that aren't compatible with Python 3.14 will now need to specify Python 3.13 explicitly:
https://devcenter.heroku.com/articles/python-support#specify-a-python-version

However most apps should be compatible, since Python 3.14 was released a couple of months ago (2025-10-07), does not contain significant breaking changes over Python 3.13, and has been happily used by the python-getting-started project since 2025-10-10.

See:
https://docs.python.org/3.14/whatsnew/3.14.html

GUS-W-17595747.

Previously if a new app did not specify a Python version (e.g. via a
`.python-version` file), then the buildpack would default to the latest
Python 3.13 release.

Now the buildpack will use the latest Python 3.14 release.

This does not affect:
* apps that specify an explicit Python version
* existing apps that have already had a build using the previous default
  version (since that version is remembered from one build to the next,
  via the "version pinning" / "sticky versions" feature).

Use-cases involving new apps that aren't compatible with Python 3.14
will now need to specify Python 3.13 explicitly:
https://devcenter.heroku.com/articles/python-support#specify-a-python-version

However most apps should be compatible, since Python 3.14 was released a
couple of months ago (2025-10-07), does not contain significant breaking
changes over Python 3.13, and has been happily used by the
python-getting-started project since 2025-10-10.

See:
https://docs.python.org/3.14/whatsnew/3.14.html

GUS-W-17595747.
@edmorley edmorley self-assigned this Dec 4, 2025
@edmorley edmorley marked this pull request as ready for review December 4, 2025 20:53
@edmorley edmorley requested a review from a team as a code owner December 4, 2025 20:53
@edmorley edmorley enabled auto-merge (squash) December 4, 2025 22:33
@edmorley edmorley merged commit 2b1f8a0 into main Dec 4, 2025
5 of 6 checks passed
@edmorley edmorley deleted the default-python-3.14 branch December 4, 2025 22:56
@heroku-linguist heroku-linguist bot mentioned this pull request Dec 5, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants