Heroku Cloud Native Buildpack: Python

heroku/python is the Heroku Cloud Native Buildpack for Python applications. It builds Python application source code into application images with minimal configuration.

Important

This is a Cloud Native Buildpack, and is a component of the Heroku Cloud Native Buildpacks project, which is in preview. If you are instead looking for the Heroku Classic Buildpack for Python (for use on the Heroku platform), you may find it here.

Usage

Note

Before getting started, ensure you have the pack CLI installed. Installation instructions are available here.

To build a Python application codebase into a production image:

$ cd ~/workdir/sample-python-app
$ pack build sample-app --builder heroku/builder:24

Then run the image:

docker run --rm -it -e "PORT=8080" -p 8080:8080 sample-app

Application Requirements

A requirements.txt or poetry.lock file must be present in the root (top-level) directory of your app's source code.

Configuration

Python Version

By default, the buildpack will install the latest version of Python 3.13.

To install a different version, add a .python-version file to your app's root directory that declares the version number to use:

$ cat .python-version
3.13

Contributing

Issues and pull requests are welcome. See our contributing guidelines if you would like to help.