Usage
Description
Start a sweep agent.
Poll the W&B server for hyperparameter configurations from
the sweep and start a run for each configuration.
The agent exits when the sweep completes, the sweep
is stopped, cancelled, or the --count limit is reached.
Find the sweep ID within the Sweeps tab in the W&B App
or in the output of the wandb sweep command when you create a new sweep.
The sweep ID can include the entity and project path
(entity/project/sweep_id) or the eight character sweep ID.
For example, to start an agent for a sweep with a sweep ID of wbyz9876:
To start an agent with a run limit of 10 runs for the sweep:
To start an agent for a sweep and save it to a project
called “sweeps-project” that belongs to the “team-awesome” entity:
To forward signals to child runs for clean shutdown:
Arguments
Options
Last modified on September 11, 2026