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-17595751.

@edmorley edmorley self-assigned this 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-17595751.
@edmorley edmorley force-pushed the default-python-3.14 branch from 48e47d7 to 36ba4bc Compare December 4, 2025 22:26
@edmorley edmorley marked this pull request as ready for review December 4, 2025 22:32
@edmorley edmorley requested a review from a team as a code owner December 4, 2025 22:32
@edmorley edmorley changed the title Use Python 3.14 as the default Python version for new apps Update the default Python version from 3.13 to 3.14 Dec 4, 2025
@edmorley edmorley enabled auto-merge (squash) December 4, 2025 22:33
@edmorley edmorley merged commit cb2d17e into main Dec 4, 2025
6 checks passed
@edmorley edmorley deleted the default-python-3.14 branch December 4, 2025 22:57
heroku-linguist bot added a commit that referenced this pull request Dec 5, 2025
## heroku/python

### Changed

- Updated the default Python version from 3.13 to 3.14. ([#478](#478))
- The Python 3.14 version alias now resolves to Python 3.14.2. ([#479](#479))
- The Python 3.13 version alias now resolves to Python 3.13.11. ([#479](#479))
@heroku-linguist heroku-linguist bot mentioned this pull request Dec 5, 2025
heroku-linguist bot added a commit that referenced this pull request Dec 5, 2025
## heroku/python

### Changed

- Updated the default Python version from 3.13 to 3.14. ([#478](#478))
- The Python 3.14 version alias now resolves to Python 3.14.2. ([#479](#479))
- The Python 3.13 version alias now resolves to Python 3.13.11. ([#479](#479))

Co-authored-by: heroku-linguist[bot] <136119646+heroku-linguist[bot]@users.noreply.github.com>
heroku-linguist bot added a commit to heroku/cnb-builder-images that referenced this pull request Dec 5, 2025
## heroku/python

### Changed

- Updated the default Python version from 3.13 to 3.14. ([#478](heroku/buildpacks-python#478))
- The Python 3.14 version alias now resolves to Python 3.14.2. ([#479](heroku/buildpacks-python#479))
- The Python 3.13 version alias now resolves to Python 3.13.11. ([#479](heroku/buildpacks-python#479))
heroku-linguist bot added a commit to heroku/cnb-builder-images that referenced this pull request Dec 5, 2025
## heroku/python

### Changed

- Updated the default Python version from 3.13 to 3.14. ([#478](heroku/buildpacks-python#478))
- The Python 3.14 version alias now resolves to Python 3.14.2. ([#479](heroku/buildpacks-python#479))
- The Python 3.13 version alias now resolves to Python 3.13.11. ([#479](heroku/buildpacks-python#479))

Co-authored-by: heroku-linguist[bot] <136119646+heroku-linguist[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants