buildpacks-python
buildpacks-python copied to clipboard
Heroku's Cloud Native Buildpack for Python applications.
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:22
Then run the image:
docker run --rm -it -e "PORT=8080" -p 8080:8080 sample-app
Application Requirements
A requirements.txt
file must be present at the root of your application's repository.
Configuration
Python Version
By default, the buildpack will install the latest version of Python 3.12.
To install a different version, add a runtime.txt
file to your app’s root directory that declares the exact version number to use:
$ cat runtime.txt
python-3.12.4
In the future this buildpack will also support specifying the Python version via a .python-version
file (see #6).
Contributing
Issues and pull requests are welcome. See our contributing guidelines if you would like to help.