> This page is for version dev.
> 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/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 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.

Released `dynamo-planner` images bundle matching Dynamo and AISimulate artifacts. The AISimulate
Python wheel and Rust crate must come from the same source revision.

For Dynamo source development, follow [Dynamo Sweeper Integration](/dynamo/dev/knowledge-base/concepts/simulation/ai-simulate/sweeper/dynamo-integration#install)
to install the dependency declared by your checkout and rebuild the matching Dynamo bindings.