Skip to content

Installation

Requirements

  • Python >= 3.10
  • A running Temporal server (for production use)

Install from PyPI

pip install langgraph-temporal

Or with uv:

uv add langgraph-temporal

This installs the core dependencies:

  • langgraph >= 1.0.0
  • temporalio >= 1.7.0

Optional dependencies

For encryption support (AES-GCM or Fernet):

pip install langgraph-temporal cryptography

For OpenTelemetry metrics:

pip install langgraph-temporal opentelemetry-api opentelemetry-sdk

Running a local Temporal server

For development, you can run Temporal locally with Docker Compose. The repository includes a pre-configured setup:

git clone https://github.com/pradithya/langgraph-temporal.git
cd langgraph-temporal

cp .env.ci .env
make start_temporal

This starts:

  • Temporal Server on localhost:7233 (gRPC)
  • Temporal Web UI on http://localhost:8233
  • PostgreSQL as the persistence backend
  • Elasticsearch for workflow visibility

To stop:

make stop_temporal

Temporal CLI

For a lighter-weight setup, you can also use the Temporal CLI:

temporal server start-dev

This starts a single-node Temporal server at localhost:7233 with the Web UI at http://localhost:8233.