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

# Getting Started

You use this web-based tool to run real-time conversation tests for voice agents. You access the source code in the watsonx Orchestrate ADK repository.

## Prerequisites

Install the following tools on your computer before you begin:

* Git
* Docker Engine
* Python
* pip

## Quick start

Follow these steps to set up and run the tool.

<Steps>
  <Step title="Clone the watsonx Orchestrate ADK repository">
    <CodeGroup>
      ```bash HTTPS theme={null}
      git clone https://github.com/IBM/ibm-watsonx-orchestrate-adk.git
      cd ibm-watsonx-orchestrate-adk
      ```

      ```bash SSH theme={null}
      git clone git@github.com:IBM/ibm-watsonx-orchestrate-adk.git
      cd ibm-watsonx-orchestrate-adk
      ```

      ```bash GitHub CLI theme={null}
      gh repo clone IBM/ibm-watsonx-orchestrate-adk
      cd ibm-watsonx-orchestrate-adk
      ```
    </CodeGroup>
  </Step>

  <Step title="(Optional) Create a virtual environment">
    <CodeGroup>
      ```bash macOS & Linux theme={null}
      python -m venv .venv
      source ./.venv/bin/activate
      ```

      ```powershell Windows theme={null}
      python -m venv .venv
      .\.venv\Scripts\activate
      ```
    </CodeGroup>
  </Step>

  <Step title="Install watsonx Orchestrate ADK">
    ```bash BASH theme={null}
    pip install ibm-watsonx-orchestrate
    ```
  </Step>

  <Step title="Navigate to the tool directory">
    <CodeGroup>
      ```bash macOS & Linux theme={null}
      cd /examples/voice
      ```

      ```powershell Windows theme={null}
      cd .\examples\voice
      ```
    </CodeGroup>
  </Step>

  <Step title="Start the tool">
    Run the following command to start the application:

    ```bash BASH theme={null}
    uvicorn app:app --host 0.0.0.0 --port 9511
    ```

    Open your browser and go to:

    * **Browser UI**: `http://localhost:9511/`
  </Step>
</Steps>

## Environment Variables

* `PORT`: Defines the port where the application runs. The default value is `9511`.