> This page is for version v1.5.1.
> For other versions, use one of these documentation indexes:
> - Latest (v1.5.1) (default): https://docs.nvidia.com/dynamo/latest/llms.txt
> - dev: https://docs.nvidia.com/dynamo/dev/llms.txt
> - v1.5.1: https://docs.nvidia.com/dynamo/v1.5.1/llms.txt
> - v1.5.0: https://docs.nvidia.com/dynamo/v1.5.0/llms.txt
> - v1.4.2: https://docs.nvidia.com/dynamo/v1.4.2/llms.txt
> - v1.4.1: https://docs.nvidia.com/dynamo/v1.4.1/llms.txt
> - v1.4.0: https://docs.nvidia.com/dynamo/v1.4.0/llms.txt
> - v1.3.0: https://docs.nvidia.com/dynamo/v1.3.0/llms.txt
> - v1.2.1: https://docs.nvidia.com/dynamo/v1.2.1/llms.txt
> - v1.2.0: https://docs.nvidia.com/dynamo/v1.2.0/llms.txt
> - v1.1.1: https://docs.nvidia.com/dynamo/v1.1.1/llms.txt
> - v1.1.0: https://docs.nvidia.com/dynamo/v1.1.0/llms.txt
> - v1.0.2: https://docs.nvidia.com/dynamo/v1.0.2/llms.txt
> - v1.0.1: https://docs.nvidia.com/dynamo/v1.0.1/llms.txt
> - v1.0.0: https://docs.nvidia.com/dynamo/v1.0.0/llms.txt
> - v0.9.1: https://docs.nvidia.com/dynamo/v-0-9-1/llms.txt
> - v0.9.0: https://docs.nvidia.com/dynamo/v-0-9-0/llms.txt
> - v0.8.1: https://docs.nvidia.com/dynamo/v-0-8-1/llms.txt
> - v0.8.0: https://docs.nvidia.com/dynamo/v-0-8-0/llms.txt
> - v0.7.1: https://docs.nvidia.com/dynamo/v-0-7-1/llms.txt
> - v0.7.0: https://docs.nvidia.com/dynamo/v-0-7-0/llms.txt

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

# AISimulate (Experimental)

<Warning>
**Experimental.** AISimulate 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>

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

Use `aisimulate predict --stack engine` for an engine-only prediction. Use `aisimulate predict
--stack dynamo` to add Dynamo Router and Planner adapters. Both commands read the same YAML schema;
the `ai-dynamo` package owns and validates the optional `router` and `planner` sections. Use
`aisimulate recommend` with the same stack selection to search configuration domains.

<Warning>
The former Dynamo online replay adapter has no replacement in the unified CLI yet. `aisimulate
predict` and `aisimulate recommend` are offline-only. Online replay will return in a future
release.
</Warning>

## Sweeper

[Sweeper](/dynamo/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 AISimulate. 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 AISimulate engine and replay
path. They have no adapter migration.

## Install

AISimulate requires Python 3.11 through 3.13. Dynamo itself still supports Python 3.10, but the
`aisimulate` dependency and its CLI are not installed in a Python 3.10 environment.

The `dynamo-planner` image installs the published `aisimulate==0.12.0` wheel from its local
wheelhouse. Dynamo builds `aisimulate-core==0.12.0` from crates.io instead of vendoring the
AISimulate source tree.

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

```bash
python3 -m pip install "aisimulate==0.12.0"
python3 -m pip install --no-deps -e .
python3 -m pip install -r container/deps/requirements.planner.txt
```