> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# wandb controller

export const GitHubLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="github-source-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    GitHub source
  </a>;

<GitHubLink url="https://github.com/wandb/wandb/blob/v0.26.1/wandb/cli/cli.py#L2381" />

## Usage

```bash theme={null}
controller [OPTIONS] SWEEP_ID
```

## Description

Start a local sweep controller for a W\&B hyperparameter sweep.

Start a local process that orchestrates the specified sweep. Read the
sweep configuration from W\&B, select hyperparameter combinations based
on the configured search strategy (grid, random, Bayesian, and so on),
and dispatch runs to sweep agents.

By default, W\&B runs sweep controllers on its managed infrastructure.
Use this command to run the controller locally instead. For example, you
can use this command to debug behavior or operate in environments with
limited connectivity.

sweep\_id is printed by `wandb sweep` when you create a sweep. It
consists of a unique identifier for the sweep and may include the
entity and project path (entity/project/sweep\_id).

For example, to start a local sweep controller for a sweep with sweep ID wbyz9876:

```bash theme={null}
wandb controller wbyz9876
```

## Arguments

| Name       | Default | Type |
| ---------- | ------- | ---- |
| `sweep_id` | STR     | True |

## Options

| Flag        | Type      | Description                                                |
| ----------- | --------- | ---------------------------------------------------------- |
| `--verbose` | BOOL Flag | Display verbose output from controller. **Default**: False |
