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

# AI Simulate (Experimental)

<Warning>
**Experimental.** AI Simulate is intended for evaluation and feedback, not production capacity
planning. Its Python APIs, configuration schemas, search results, and deployment output may
change without a standard deprecation period.
</Warning>

AI Simulate is a standalone Python distribution. It provides inference-engine forward-pass
simulation, deployment simulation, and search without depending on `ai-dynamo`.

For an engine-only single replay run, use `python -m aisimulate.replay`. For a replay with Dynamo
Router, Planner, or online adapters, use `python -m dynamo.replay`. Both commands share their base
replay configuration; Dynamo extends it with adapter options. The selected runtime validates each
`--*-engine-args` JSON payload, so runtime-specific fields can differ. For configuration search, call
`Sweeper(runner_factory=...).run(config)`.

## Sweeper

[Sweeper](/dynamo/dev/knowledge-base/concepts/simulation/ai-simulate/sweeper/overview) searches backend deployment settings against an injected replay runner.
Its core owns backend search, candidate orchestration, scoring, and the versioned `ReplaySpec`
contract.

Optional adapters extend the search without adding a Dynamo dependency to AI Simulate. The
`ai-dynamo` wheel registers the `dynamo.planner` and `dynamo.router` adapters. Selecting either
adapter imports its Dynamo implementation and adds a versioned runtime hook to the replay
specification.

KVBM search settings are deprecated and are not supported by the AI Simulate engine and replay
path. They have no adapter migration.

## Install

The `dynamo-planner` image installs the published `aisimulate==0.1.0.dev1` wheel from its local
wheelhouse. Dynamo builds `aisimulate-core==0.1.0-dev.1` from crates.io instead of vendoring the
AI Simulate source tree.

For Dynamo source development, install the published AI Simulate wheel, Dynamo, and the Planner
dependencies from the Dynamo repository root:

```bash
uv pip install "aisimulate==0.1.0.dev1"
uv pip install --no-deps -e .
uv pip install -r container/deps/requirements.planner.txt
```