Skip to content

Common vLLM flags (quick reference)

Full reference: vLLM engine arguments.

FlagMeaning
--tensor-parallel-sizeSplit the model across N GPUs (TP)
--max-model-lenMax context length to support (bounds KV-cache size)
--gpu-memory-utilizationFraction of GPU memory vLLM may use
--max-num-seqsMax concurrent requests
--max-num-batched-tokensPrefill chunk size / per-step token budget
--enable-prefix-cachingReuse KV cache for shared prompt prefixes
--kv-cache-dtype fp8Store KV cache in 8-bit
--quantizationWeight quantization scheme to use
--speculative-configEnable/configure speculative decoding
--enforce-eagerDisable CUDA graphs (slower, more compatible)
--trust-remote-codeAllow running model-supplied Python code (needed by some architectures)
--served-model-nameThe model name clients use in API calls
--hf-overridesPatch fields in the model’s HF config at load time
--override-generation-configPatch the model’s default sampling params (temperature, top_p, …)
--tool-call-parser / --reasoning-parserWhich parser converts the model’s raw markup into API fields
--attention-backendWhich attention kernel library to use
--language-model-onlySkip loading the vision part of a multimodal model