Set up ADK with your 30-day free trial of watsonx Orchestrate. With it, you can use ADK with your 30-day trial environment, you can also pull the watsonx Developer Edition iamges in order to run in a local environment.

1

Set up a free trial instance

Create a watsonx Orchestrate SaaS trial instance on IBM Cloud. For more information, see Trial access on IBM Cloud.

2

Get your credentials

Launch your Orchestrate instance and get your service instance URL and API key. For more information, see IBM Cloud.

3

Configure your .env file

To use watsonx Orchestrate Developer Edition, create a .env file with the following content:

[.env]
WO_INSTANCE=<watsonx orchestrate service instance url>
WO_API_KEY=<watsonx orchestrate api key>
WO_DEVELOPER_EDITION_SOURCE=orchestrate
USE_SAAS_ML_TOOLS_RUNTIME=True
4

Start your local environment

Start the watsonx Orchestrate Developer Edition with this command:

[BASH]
orchestrate server start -e <.env file path>

Note: After pulling the images for the first time, add WO_DEVELOPER_EDITION_SKIP_LOGIN=true to your .env file to avoid pulling them again and prevent version-related errors.

5

Activate your instance

Run the following command to activate your local instance:

[BASH]
orchestrate env activate local

If you prefer not to run the full stack locally, connect ADK to the cloud-hosted (SaaS) instance you just created. For more information, see Configuring your environments.