> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.nvidia.com/dynamo/llms.txt. For full content including API reference and SDK examples, see https://docs.nvidia.com/dynamo/llms-full.txt.

# Sweeper Quickstart

<Warning>
**Experimental.** Sweeper is intended for evaluation and feedback, not production capacity
planning.
</Warning>

Install AI Simulate:

```bash
python -m pip install "aisimulate==0.1.0.dev1"
```

Sweeper requires a `RunnerFactory` supplied by the application that owns replay execution:

```python
from aisimulate.sweeper import SmartSearchConfig, Sweeper

config = SmartSearchConfig.from_yaml("sweep.yaml")
sweeper = Sweeper(runner_factory=my_runner_factory, show_progress=False)
candidates = sweeper.run(config)
```

Set `sweep.parallel_evals` above one to use spawned worker processes. Scripts using that mode must
guard their entrypoint with `if __name__ == "__main__":`.

Next, read the [Tutorial](/dynamo/dev/knowledge-base/concepts/simulation/ai-simulate/sweeper/tutorial) for the complete configuration flow or [Sweep Configuration
Providers](/dynamo/dev/knowledge-base/concepts/simulation/ai-simulate/sweeper/sweep-configuration-providers) to add feature-specific search dimensions.