Skip to main content

Configure Runtime Behavior

First identify when the setting takes effect:

LifecycleExamplesRebuild required?
BuildPrecision, quantization, engine shapes, topologyYes
Bundle defaultPackaged model/runtime defaultsYes, unless edited by supported tooling
LoadBackend/model DSO search, runtime cache, CUDA-graph policy, registered configNo
RequestPrompt, sampling, diffusion steps, language, input mediaNo

Registered configuration uses a JSON file or repeatable overrides:

trtmc run model.bundle \
--config runtime.json \
--set runtime.disable_cuda_graph=true \
--prompt "Hello"

The native CLI validates explicit fields against registered schemas. Unknown namespaces, fields, invalid types, and out-of-range values fail. An optimized implementation can accept or reject the same public LoadOptions according to its exact provider contract; it does not automatically inherit native config semantics.

Use Configuration Reference for the live schema catalog and backend/cache behavior. Use Quantization and Multi-Device Execution for their model-owned build contracts.