Skip to content
The official Heroku buildpack for Python apps.
Shell Makefile
Latest commit 92b4f5e May 5, 2016 @kennethreitz kennethreitz pypy v5.1.0 v5.1.1
Failed to load latest commit information.
bin Add PyNaCl to the list of packages that trigger libffi bootstrapping Apr 21, 2016
builds pypy v5.1.0 v5.1.1 May 5, 2016
vendor use older pip for pip-pop Mar 31, 2016
.gitignore ignore site folder Mar 23, 2012 v80 Apr 5, 2016
LICENSE 2016 Feb 25, 2016
Makefile make tools May 4, 2015 Update Mar 22, 2016
requirements.txt changes Jul 15, 2014

Heroku Buildpack: Python


This is the official Heroku buildpack for Python apps, powered by pip and other excellent software.

Recommended web frameworks include Django and Flask. The recommended webserver is Gunicorn. There are no restrictions around what software can be used (as long as it's pip-installable). Web processes must bind to $PORT, and only the HTTP protocol is permitted for incoming connections.

Some Python packages with obscure C dependencies (e.g. scipy) are not compatible.

See it in Action

Deploying a Python application couldn't be easier:

$ ls
Procfile  requirements.txt

$ heroku create --buildpack heroku/python

$ git push heroku master
-----> Python app detected
-----> Installing python-2.7.11
     $ pip install -r requirements.txt
       Collecting requests (from -r requirements.txt (line 1))
         Downloading requests-2.9.1-py2.py3-none-any.whl (501kB)
       Installing collected packages: requests
       Successfully installed requests-2.9.1

-----> Discovering process types
       Procfile declares types -> (none)

A requirements.txt file must be present at the root of your application's repository.

You can also specify the latest production release of this buildpack for upcoming builds of an existing application:

$ heroku buildpacks:set heroku/python

Specify a Python Runtime

Specific versions of the Python runtime can be specified with a runtime.txt file:

$ cat runtime.txt

Runtime options include:

  • python-2.7.11
  • python-3.5.1
  • pypy-5.0.1 (unsupported, experimental)

Other unsupported runtimes are available as well. Use at your own risk.

Something went wrong with that request. Please try again.