python

Python Starter

Build your Temporal application in Python (docs)

• Overview
• Quick start
  • Workflow
  • Starter

Overview

Important

Make sure you have followed the instructions to configure your development environment before reading this section.

This repository is designed to be a quick-start for your Python Temporal application. It is designed to be quick and easy to get started, rather than any example of best practice.

This starter application consists of two parts:

• src/worker.py: this is where you define your workflow and contains the main business logic for your Temporal application.
• src/starter.py: this is how your trigger your workflow with any input variables and where you await the response.

Quick start

Install dependencies using uv:

cd python
uv sync
source .venv/bin/activate

Workflow

cd python
uv run poe dev

The workflow is a long-running application. For rapid development, the recommendation is to use the file watcher.

You can also run this with uv run src/worker.py and restarting after every code change.

Starter

cd python
uv run src/starter.py

The starter will usually be something that runs to completion.