Sweeper Quickstart

Run a backend-neutral sweep with an injected replay runtime

View as Markdown

Experimental. Sweeper is intended for evaluation and feedback, not production capacity planning.

From the Dynamo checkout root, install the AISimulate dependency declared by that checkout:

python3 -m pip install -r container/deps/requirements.aisimulate.txt

If you use the Dynamo replay runner, complete Dynamo Sweeper Integration to build bindings against the matching AISimulate Rust crate.

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

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 for the complete configuration flow or Sweep Configuration Providers to add feature-specific search dimensions.