> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enabling watsonx/* LLMs

The **watsonx Orchestrate Developer Edition** now supports integration with the **wxO SaaS tenant** for LLM inferencing. Previously, developers were required to configure the Developer Edition using their own `watsonx.ai` API key and Space ID. This update simplifies the setup process by enabling proxy usage through Watsonx Orchestrate.

## Prerequisites

To retrieve the necessary configuration details, you must have access to an instance of **watsonx Orchestrate**.

## Environment Configuration

Additional environment variables are required to enable proxy usage. These variables differ based on the deployment type:

* [**SaaS Deployment**](#saas-deployment-configuration)
* [**On-premises Deployment**](#on-premises-deployment-configuration)

### Common Parameters

| Variable                    | Description                                                                |
| --------------------------- | -------------------------------------------------------------------------- |
| `AUTHORIZATION_URL`         | IAM URL used to authorize watsonx Orchestrate to access the proxy service. |
| `USE_SAAS_ML_TOOLS_RUNTIME` | Enables the ADK to use the proxy.                                          |

### SaaS Deployment Configuration

For SaaS deployments, use the following environment variables:

```env theme={null}
WO_API_KEY=<your API key for Watson Orchestrate on SaaS>
WO_INSTANCE=<your service instance URL>
# The below two fields are optional and automatically inferred by the Developer Edition
AUTHORIZATION_URL=<your IAM URL>
USE_SAAS_ML_TOOLS_RUNTIME=True
```

<Note>
  **Note:**\
  `watsonx.ai` API Key and Space ID are no longer required.
</Note>

### On-premises Deployment Configuration

For on-premises deployments, use the following environment variables:

<Tabs>
  <Tab title="authenticating with password">
    ```env theme={null}
    WO_USERNAME=<your username for onprem>
    WO_PASSWORD=<your password for onprem>
    WO_INSTANCE=<your service instance URL>
    AUTHORIZATION_URL=<your IAM URL>
    ```

    | Variable            | Description                                                                             |
    | ------------------- | --------------------------------------------------------------------------------------- |
    | `WO_USERNAME`       | Username used to log in to IBM SoftwareHub.                                             |
    | `WO_PASSWORD`       | Password associated with `WO_USERNAME`.                                                 |
    | `WO_INSTANCE`       | watsonx Orchestrate server instance URL                                                 |
    | `AUTHORIZATION_URL` | Optional, an IAM URL used to authorize watsonx Orchestrate to access the proxy service. |
  </Tab>

  <Tab title="authenticating with API key">
    ```env theme={null}
    WO_USERNAME=<your username for onprem>
    WO_API_KEY=<your API key for onprem>
    WO_INSTANCE=<your service instance URL>
    AUTHORIZATION_URL=<your IAM URL>
    ```

    | Variable            | Description                                                                             |
    | ------------------- | --------------------------------------------------------------------------------------- |
    | `WO_USERNAME`       | Username used to log in to IBM SoftwareHub.                                             |
    | `WO_API_KEY`        | API key associated with `WO_USERNAME`.                                                  |
    | `WO_INSTANCE`       | watsonx Orchestrate server instance URL                                                 |
    | `AUTHORIZATION_URL` | Optional, an IAM URL used to authorize watsonx Orchestrate to access the proxy service. |
  </Tab>
</Tabs>