Python

Add to your project

Paste this entry into the components list in diploi.yaml to add Python to your project.

components:
  - name: Python
    identifier: python
    package: https://github.com/diploi/component-python#v05.2026

If the folder of the component in your repository is not named python, add a folder parameter with the name of the folder.
Import the environment variables of add-ons, such as a database, into the component with env.include in diploi.yaml:

components:
  - name: Python
    identifier: python
    package: https://github.com/diploi/component-python#v05.2026
    env:
      include:
        - postgres.*

Python reference

Readme

Operation

Getting started

In the Dashboard, click Create Project +
Under Pick Components, choose Python. Here you can also add a frontend framework to create a monorepo app, eg, Python for backend and React+Vite for frontend
In Pick Add-ons, you can add one or multiple databases to your app
Choose Create Repository to generate a new GitHub repo
Finally, click Launch Stack

Development

During development, the container installs watchfiles to enable automatic reloads when files change. The development server is started with:

uv run watchfiles "python src/main.py"

This will:

Use watchfiles to watch for file changes and restart the server automatically.
Run src/main.py in an isolated Python environment managed by uv.
Automatically detect whether to use pyproject.toml or requirements.txt for dependency resolution.

Production

Builds a production-ready image. During the build, dependencies are installed with uv sync or uv pip install. When the container starts, it runs:

uv run --frozen src/main.py

This starts your Python application using the exact dependency versions locked in the project.