temporalio-python

Flox development environment for the Temporal Python SDK.

Quick start

# Clone and activate locally
git clone https://github.com/flox/temporalio-python.git
cd temporalio-python
flox activate

# Start the Temporal dev server (gRPC :7233, Web UI :8233)
flox services start

# Or use remotely without cloning (e.g., inside an existing project)
# flox activate -r flox/temporalio-python

Run a sample workflow

# In a new terminal inside the activated environment
git clone https://github.com/temporalio/samples-python.git
cd samples-python

# Install dependencies
uv sync

# Start the worker
uv run python hello/hello_activity/worker.py &

# Execute the workflow
temporal workflow execute \
  --task-queue hello-activity-task-queue \
  --type GreetingWorkflow \
  --input '"World"'

# Open http://localhost:8233 to see the workflow in the Web UI

What's included

Category	Packages
Language	Python 3.12
Package manager	uv
Temporal	temporal-cli 1.6.2 (CLI + embedded dev server + Web UI)
Rust	rustup, maturin (for building sdk-core native bridge)
Protobuf	protobuf (protoc)
Utilities	git, jq, curl, grpcurl, sqlite, openssl

Services

flox services start     # Start Temporal dev server
flox services status    # Check status
flox services stop      # Stop dev server

The temporal-dev service runs temporal server start-dev with SQLite persistence at $FLOX_ENV_CACHE/temporal-dev.db. Data survives restarts.

Environment variables

Variable	Value	Purpose
TEMPORAL_ADDRESS	localhost:7233	Default server address for CLI and SDK
TEMPORAL_UI_PORT	8233	Web UI port
UV_CACHE_DIR	$FLOX_ENV_CACHE/uv-cache	uv cache inside Flox cache

Platforms

aarch64-darwin, x86_64-darwin, x86_64-linux, aarch64-linux