> ## 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.

# Runs-elsewhere

## Overview

Runs-elsewhere mode is used when an agent or application runs outside the watsonx Orchestrate runtime. This mode uses instance credentials to authenticate and send requests to the platform.

## Authentication

Authentication is handled by providing instance credentials, such as API key and instance URL. The SDK manages token generation and request authentication.

### Examples

#### AWS production

```python PYTHON [expandable] theme={null}
from ibm_watsonx_orchestrate_sdk import Client

client = Client(
    api_key='api_key',
    instance_url='https://api.dl.watson-orchestrate.ibm.com/instances/20250430-0949-0287-00f2-33dc583100c9'
)
```

#### CPD

```python PYTHON [expandable] theme={null}
from ibm_watsonx_orchestrate_sdk import Client
client = Client(
    password='password',
    username='https://cpd-cpd-instance-1.apps.wo-533-br-source.cp.fyre.ibm.com/orchestrate/cpd-instance-1/instances/1777441537260557'
)
```

#### HIPAA

```python PYTHON [expandable] theme={null}
from ibm_watsonx_orchestrate_sdk import Client

client = Client(
    api_key='api_key',
    instance_url='https://api.dl.watson-orchestrate.ibm.com/instances/20250430-0949-0287-00f2-33dc583100c9',
    iam_url="",
    auth_type = "mcsp_v2"
)
```

#### Local (developer edition)

```python PYTHON theme={null}
from ibm_watsonx_orchestrate_sdk import Client
client = Client()
```

<Note>
  * Instance credentials are required for authentication.
  * The SDK manages token handling internally.
  * Requests are routed through the configured instance URL.
  * Local configuration applies only when running developer edition locally.
</Note>

### References

* [Client](/sdk/client)
* [Chat models](/sdk/chat_wxo)