Python

Erkannt über requirements.txt, Pipfile oder pyproject.toml.

Schritt-für-Schritt-Guides: Python, Django, Flask, FastAPI, Streamlit.

Siehe Buildpacksfür Detection und Versionspolitik.

Erkennt

requirements.txt, Pipfile oder pyproject.toml im Base directory.

Versionen

Default ist Python 3.13. Veröffentlichte Lines Stand September 2026: 3.10-3.14. Du bekommst den neuesten Patch der angefragten Minor.

Pinnen, in dieser Reihenfolge:

  • .python-version
  • runtime.txt (python-3.12 geht)
  • requires-python in pyproject.toml (ein Range nimmt die höchste passende veröffentlichte Version)

Install und Build

  • poetry.lock: Poetry, poetry install --only main
  • Pipfile.lock: Pipenv, pipenv install --deploy --system
  • requirements.txt: pip install -r requirements.txt
  • pyproject.toml mit [tool.poetry] und ohne Lockfile: Poetry
  • sonst: pip install .

pip, Poetry und Pipenv installiert der Builder in festen Versionen, die auf allen unterstützten Python-Versionen laufen. Wir heben sie regelmäßig an; mit einem Deploy ohne Cache bekommt deine App die aktuellen.

Django-Apps (manage.py plus eine Django-Dependency) führen collectstatic --noinput aus. Ein Fehler dort wird geloggt und lässt den Build nicht scheitern.

Launch setzt PYTHONUNBUFFERED=1. Django bekommt außerdem DJANGO_ENV=production und, wenn eine Datei */wsgi.py existiert, DJANGO_SETTINGS_MODULE.

Start-Command

  • Django: gunicorn <dir>.wsgi --bind 0.0.0.0:$PORT --workers 3
  • FastAPI / Starlette: uvicorn main:app --host 0.0.0.0 --port $PORT (oder app:app, wenn diese Datei die App hält)
  • Flask: Gunicorn auf app:app, application:app oder wsgi:app
  • sonst python app.py oder python main.py

gunicorn oder uvicorn in die Dependencies legen, wenn du diese Defaults nutzt. Mit einer Procfile überschreiben. Auf PORT lauschen.

Passt nichts davon, muss die Procfile die Prozesse festlegen: mindestens eine gültige Zeile außer release:, zum Beispiel web: oder worker:. Sonst bricht der Build mit einer Fehlermeldung ab, statt das App-Verzeichnis auszuliefern. Eine reine Worker-App (etwa ein Bot) ohne web:-Zeile braucht einen eigenen Prozess: Leg auf dem Tab Processes einen Prozess mit dem Namen aus der Procfile an (zum Beispiel worker, ohne Port) und setz den Prozess web auf 0 Instanzen.

Gib deinem Agenten eine Cloud.

Bis zu 15 € Guthaben beim Registrieren.

Weiter mit GitHub

oder per E-Mail

Bleib auf dem Laufenden.

Produktnews, kein Spam. Jederzeit abbestellen.