Temporal is a Workflow as Code platform used to build and operate resilient applications using developer friendly primitives, instead of constantly fighting your infrastructure.

temporal-java-sdk is the framework for authoring workflows and activities in Java.

If you are authoring in Go, see Temporal Go SDK.

For samples, see Samples for the Temporal Java SDK.

Follow the Quick install guide to run the Temporal Server locally. Additional information is available in the Temporal Server docker-compose repo.

CLI is avaialable as an executable or as a docker image

Find the latest release of the Temporal Java SDK at maven central.

Add temporal-sdk as a dependency to your pom.xml:

<dependency>
  <groupId>io.temporal</groupId>
  <artifactId>temporal-sdk</artifactId>
  <version>N.N.N</version>
</dependency>

or to build.gradle:

compile group: 'io.temporal', name: 'temporal-sdk', version: 'N.N.N'

The documentation on how to use the Temporal Java client is here.

Javadocs for the client API are located here.

Due to issues with default hostname resolution (see this StackOverflow question for more details), macOS Users may see gRPC DEADLINE_EXCEEDED errors and other slowdowns when running the SDK.

To solve the problem add the following entries to your /etc/hosts file (where my-macbook is your hostname):

127.0.0.1   my-macbook
::1         my-macbook

We'd love your help in making the Temporal Java SDKL great. Please review our contribution guidelines.

Apache License, please see LICENSE for details.