hub / github.com/temporalio/temporal

github.com/temporalio/temporal @v1.32.0-158.0

repository ↗ · DeepWiki ↗ · release v1.32.0-158.0 ↗ · + Follow

48,949 symbols 286,740 edges 2,733 files 16,701 documented · 34% 81 cross-repo links ● updated todayv1.30.6 · 2026-07-08★ 21,622532 open issues

Browse by type

⨍ Functions 43,335◇ Types & classes 5,614

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

Temporal—durable execution platform

temporal logo

Introduction • Getting Started • Contributing • Temporal Docs • Temporal 101

Introduction

Temporal is a durable execution platform that enables developers to build scalable applications without sacrificing productivity or reliability. The Temporal server executes units of application logic called Workflows in a resilient manner that automatically handles intermittent failures, and retries failed operations.

Temporal is a mature technology that originated as a fork of Uber's Cadence. It is developed by Temporal Technologies, a startup by the creators of Cadence.

Getting Started

Download and Start Temporal Server Locally

Execute the following commands to start a pre-built image along with all the dependencies.

brew install temporal
temporal server start-dev

Refer to Temporal CLI documentation for more installation options.

Run the Samples

Clone or download samples for Go or Java and run them with the local Temporal server. We have a number of HelloWorld type scenarios available, as well as more advanced ones. Note that the sets of samples are currently different between Go and Java.

Use CLI

Use Temporal CLI to interact with the running Temporal server.

temporal operator namespace list
temporal workflow list

Use Temporal Web UI

Try Temporal Web UI by opening http://localhost:8233 for viewing your sample workflows executing on Temporal.

Repository

This repository contains the source code of the Temporal server. To implement Workflows, Activities and Workers, use one of the supported languages.

Contributing

We'd love your help in making Temporal great.

Helpful links to get started:

work on or propose a new feature
learn about the Temporal Server architecture
learn how to build and run the Temporal Server locally
learn about Temporal Server testing tools and best practices
join the Temporal community forum and Slack

License

MIT License

Extension points exported contracts — how you extend this code

HttpGetter (Interface)

HttpGetter defines http.Client.Get(...) as an interface so we can mock it [44 implementers]

tools/tdbg/factory.go

OperatorHandler (Interface)

OperatorHandler is interface wrapping frontend workflow handler [111 implementers]

service/frontend/interface.go

HistoryClient (Interface)

HistoryClient contains the subset of methods from [historyservice.HistoryServiceClient] that we need, to make it easier [12 …

service/worker/dlq/workflow.go

MaybeTerminalTaskError (Interface)

MaybeTerminalTaskError are errors which (if IsTerminalTaskError returns true) cannot be retried and should not be resche [6 …

service/history/queues/executable.go

SizeGetter (Interface)

SizeGetter is an interface that can be implemented by cache entries to provide their size. Cache uses CacheSize() to det [8 …

common/cache/size_getter.go

TaskExecutor (Interface)

TaskExecutor is the interface for executing namespace replication tasks [67 implementers]

common/namespace/nsreplication/replication_task_executor.go

Mapper (Interface)

Mapper interface allows overriding custom search attribute names with aliases per namespace. Create an instance of a Map [8 …

common/searchattribute/mapper.go

CounterIface (Interface)

CounterIface is an ever-increasing counter. [21 implementers]

common/metrics/metrics.go

Core symbols most depended-on inside this repo

Equal

called by 11253

chasm/visibility_value.go

NoError

called by 11033

tests/testcore/test_env.go

String

called by 7181

common/archiver/uri.go

Any

called by 5423

common/testing/testvars/test_vars.go

New

called by 5109

service/matching/partition_scaler_interface.go

EXPECT

called by 4723

common/archiver/metadata_mock.go

Helper

called by 4139

common/testing/protoassert/assert.go

called by 3019

tests/testcore/test_env.go

Shape

Method 34,822

Function 8,513

Struct 4,619

Interface 560

TypeAlias 254

FuncType 181

Languages

Go100%

Modules by API surface

api/historyservice/v1/request_response.pb.go1,557 symbols

api/adminservice/v1/request_response.pb.go883 symbols

api/matchingservice/v1/request_response.pb.go852 symbols

api/persistence/v1/executions.pb.go653 symbols

api/historyservice/v1/request_response.go-helpers.pb.go648 symbols

api/deployment/v1/message.pb.go577 symbols

service/history/interfaces/mutable_state_mock.go542 symbols

service/history/workflow/mutable_state_impl.go408 symbols

api/historyservice/v1/service_grpc.pb.go407 symbols

api/adminservice/v1/request_response.go-helpers.pb.go380 symbols

api/historyservicemock/v1/service_grpc.pb.mock.go364 symbols

api/matchingservice/v1/request_response.go-helpers.pb.go336 symbols

Dependencies from manifests, versioned

cel.dev/exprv0.25.1 · 1×

cloud.google.com/gov0.123.0 · 1×

cloud.google.com/go/authv0.20.0 · 1×

cloud.google.com/go/auth/oauth2adaptv0.2.8 · 1×

cloud.google.com/go/compute/metadatav0.9.0 · 1×

cloud.google.com/go/iamv1.9.0 · 1×

cloud.google.com/go/longrunningv0.11.0 · 1×

cloud.google.com/go/monitoringv1.27.0 · 1×

cloud.google.com/go/runv1.19.0 · 1×

cloud.google.com/go/storagev1.62.1 · 1×

dario.cat/mergov1.0.2 · 1×

filippo.io/edwards25519v1.2.0 · 1×

Datastores touched

(mysql)Database · 1 repos

For agents

$ claude mcp add temporal \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact