Hatchet Walkthrough

This guide is intended for users who want to explore Hatchet in more depth beyond the quickstart. If you haven’t already set up Hatchet, please see the Hatchet Cloud Quickstart or the Self-Hosting Quickstart first.

Set environment variables

All Hatchet SDKs require the HATCHET_CLIENT_TOKEN environment variable to be set. This token is automatically created when you run a CLI command like hatchet worker dev or hatchet trigger, but if you’re setting up a project manually, you’ll need to set this variable yourself. You can generate an API token from the Hatchet frontend by navigating to the Settings tab and clicking on the API Tokens tab. Click the Generate API Token button to create a new token. Set this environment variable in your project, and do not share it publicly.

export HATCHET_CLIENT_TOKEN="<your-client-token>"

Additionally, if you are a self-hosted user provisioning without TLS enabled, you will need to set the HATCHET_CLIENT_TLS_STRATEGY environment variable to none. If you are on Hatchet Cloud, TLS is enabled by default, so this is not required.

export HATCHET_CLIENT_TLS_STRATEGY=none

Setup your codebase

Clone a Quickstart Project

git clone https://github.com/hatchet-dev/hatchet-python-quickstart.git

CD into the project

cd hatchet-python-quickstart

Install dependencies

Create a virtual environment

poetry shell

Initialize the project and install the Hatchet SDK

poetry init --dependency hatchet-sdk

Clone a Quickstart Project

git clone https://github.com/hatchet-dev/hatchet-typescript-quickstart.git

CD into the project

cd hatchet-typescript-quickstart

Install dependencies

Create a virtual environment

poetry shell

Initialize the project and install the Hatchet SDK

poetry init --dependency hatchet-sdk

Clone a Quickstart Project

git clone https://github.com/hatchet-dev/hatchet-go-quickstart.git

CD into the project

cd hatchet-go-quickstart

Install dependencies

Create a virtual environment

poetry shell

Initialize the project and install the Hatchet SDK

poetry init --dependency hatchet-sdk

Create a new project directory and cd into it

mkdir hatchet-tutorial && cd hatchet-tutorial

Initialize a new python project with required dependencies

pip install hatchet-sdk

Create project directories

mkdir src &&
mkdir src/workflows &&
mkdir src/workers

Instantiate your Hatchet Client

It is recommended to instantiate a shared Hatchet Client in a separate file as a singleton.

Create a new file called hatchet_client.py

touch src/hatchet_client.py

Add the following code to the file:

examples/python/setup/client.py

from hatchet_sdk import Hatchet

hatchet = Hatchet()

You can now import the Hatchet Client in any file that needs it.

from src.hatchet_client import hatchet

Create a new project directory and cd into it

mkdir hatchet-tutorial && cd hatchet-tutorial

Initialize a new typescript project with required dependencies

pip install hatchet-sdk

Create project directories

mkdir src &&
mkdir src/workflows &&
mkdir src/workers

Instantiate your Hatchet Client

It is recommended to instantiate a shared Hatchet Client in a separate file as a singleton.

Create a new file called hatchet-client.ts

touch src/hatchet-client.ts

Add the following code to the file:

examples/typescript/hatchet-client.ts

import { HatchetClient } from '@hatchet/v1';

export const hatchet = HatchetClient.init();

You can now import the Hatchet Client in any file that needs it.

Create a new project directory and cd into it

mkdir hatchet-tutorial && cd hatchet-tutorial

Initialize a new go project with required dependencies

go mod init hatchet-tutorial

Create project directories

mkdir workflows && mkdir workers

Instantiate your Hatchet Client

In the workers directory, create a Hatchet client

package main
 
import (
	"log"
 
	hatchet "github.com/hatchet-dev/hatchet/sdks/go"
)
 
func main() {
	client, err := hatchet.NewClient()
	if err != nil {
		log.Fatalf("failed to create hatchet client: %v", err)
	}
}

Cd into your project directory

cd path-to-your-project

Install the Hatchet SDK and required dependencies

pip install hatchet-sdk

Create project directories

By convention it is recommended to create your workflows in the workflows directory and your workers in the workers directory.

mkdir workflows &&
mkdir workers

Instantiate your Hatchet Client

It is recommended to instantiate a shared Hatchet Client in a separate file as a singleton.

Create a new file called hatchet-client.py in your project root.

touch hatchet-client.py

Add the following code to the file:

examples/python/setup/client.py

from hatchet_sdk import Hatchet

hatchet = Hatchet()

You can now import the Hatchet Client in any file that needs it.

from src.hatchet_client import hatchet

Cd into your project directory

cd path-to-your-project

Install the Hatchet SDK and required dependencies

pip install hatchet-sdk

Create project directories

By convention it is recommended to create your workflows in the workflows directory and your workers in the workers directory.

mkdir workflows &&
mkdir workers

Instantiate your Hatchet Client

It is recommended to instantiate a shared Hatchet Client in a separate file as a singleton.

Create a new file called hatchet-client.ts in your project root.

touch hatchet-client.ts

Add the following code to the file:

examples/typescript/hatchet-client.ts

import { HatchetClient } from '@hatchet/v1';

export const hatchet = HatchetClient.init();

Cd into your project directory

cd /path/to/your-project

Create project directories

By convention it is recommended to create your workflows in the workflows directory and your workers in the workers directory.

mkdir workflows && mkdir workers

Install the Hatchet SDK and required dependencies

Create a virtual environment

poetry shell

Initialize the project and install the Hatchet SDK

poetry init --dependency hatchet-sdk

Instantiate your Hatchet Client

You can now import the Hatchet Client Factory in any file that needs it.

In the workers directory, create a Hatchet client

package main
 
import (
	"log"
 
	hatchet "github.com/hatchet-dev/hatchet/sdks/go"
)
 
func main() {
	client, err := hatchet.NewClient()
	if err != nil {
		log.Fatalf("failed to create hatchet client: %v", err)
	}
}

Continue to the next section to learn how to create your first task

Hatchet Cloud Quickstart Tasks

We use cookies

Hatchet Walkthrough

Set environment variables

Setup your codebase

Clone a Quickstart Project

CD into the project

Install dependencies

Create a virtual environment

Initialize the project and install the Hatchet SDK

Create a virtual environment

Install the Hatchet SDK

(optional) save the dependencies to a requirements.txt file

Clone a Quickstart Project

CD into the project

Install dependencies

Create a virtual environment

Initialize the project and install the Hatchet SDK

Create a virtual environment

Install the Hatchet SDK

(optional) save the dependencies to a requirements.txt file

Clone a Quickstart Project

CD into the project

Install dependencies

Create a virtual environment

Initialize the project and install the Hatchet SDK

Create a virtual environment

Install the Hatchet SDK

(optional) save the dependencies to a requirements.txt file

Create a new project directory and cd into it

Initialize a new python project with required dependencies

Create project directories

Instantiate your Hatchet Client

Create a new project directory and cd into it

Initialize a new typescript project with required dependencies

Create project directories

Instantiate your Hatchet Client

Create a new project directory and cd into it

Initialize a new go project with required dependencies

Create project directories

Instantiate your Hatchet Client

Cd into your project directory

Install the Hatchet SDK and required dependencies

Create project directories

Instantiate your Hatchet Client

Cd into your project directory

Install the Hatchet SDK and required dependencies

Create project directories

Instantiate your Hatchet Client

Cd into your project directory

Create project directories

Install the Hatchet SDK and required dependencies

Create a virtual environment

Initialize the project and install the Hatchet SDK

Create a virtual environment

Install the Hatchet SDK

(optional) save the dependencies to a requirements.txt file

Instantiate your Hatchet Client