# Qwen/Qwen3.5-9B — vLLM serving recipe

> Qwen3.5 dense multimodal model (9B) with gated delta networks hybrid attention, MTP, and 262K context

Configuration: hardware `h200` (8× H200) · strategy `single_node_tp` (Tensor Parallel) · variant `default` (BF16) · features `tool_calling`, `reasoning` · frontend `rust`

- Interactive page: https://vllm-recipes-git-fork-1195343015-modelscope-1a13f7-inferact-inc.vercel.app/Qwen/Qwen3.5-9B
- This configuration as JSON: https://vllm-recipes-git-fork-1195343015-modelscope-1a13f7-inferact-inc.vercel.app/Qwen/Qwen3.5-9B.json?hardware=h200

The commands below were rendered for exactly this configuration and take precedence over any example in the guide.

## Other configurations

Change the query string (the same parameters as the page URL) and fetch this URL again. Unknown or incompatible values fall back to the recipe default, so check the Configuration line.

- `hardware`: `h100`, `h200`, `b200`, `gb200`, `b300`, `gb300`, `mi300x`, `mi325x`, `mi350x`, `mi355x`, `arc_pro_b60`, `arc_pro_b70`
- `variant`: `default`, `fp8`, `mlx_int4`
- `strategy`: `single_node_tp`, `multi_node_tp` (multi-node strategies also need `nodes=<n>`)
- `features`: comma-separated list of `tool_calling`, `reasoning`, `spec_decoding`, `text_only`, `long_context` (default: `tool_calling`, `reasoning`). Use `features=none` to turn them all off.

## Install

Requires vLLM >= 0.17.0.

```bash
uv venv
source .venv/bin/activate
uv pip install -U vllm --torch-backend auto
```

Docker image: `vllm/vllm-openai:latest`

## Serve

```bash
export VLLM_USE_RUST_FRONTEND=1
vllm serve Qwen/Qwen3.5-9B \
  --trust-remote-code \
  --tensor-parallel-size 1 \
  --enable-auto-tool-choice \
  --tool-call-parser qwen3_coder \
  --reasoning-parser qwen3
```

Docker equivalent:

```bash
docker run --gpus all \
  --privileged --ipc=host -p 8000:8000 \
  -v ~/.cache/huggingface:/root/.cache/huggingface \
  -e VLLM_USE_RUST_FRONTEND=1 \
  vllm/vllm-openai:latest Qwen/Qwen3.5-9B \
  --trust-remote-code \
  --tensor-parallel-size 1 \
  --enable-auto-tool-choice \
  --tool-call-parser qwen3_coder \
  --reasoning-parser qwen3
```

## Known issues

### assert num_cache_lines >= batch

The CUDA graph capture size is larger than the Mamba cache. Reduce
`--max-cudagraph-capture-size` (default 512); see
[vllm#34571](https://github.com/vllm-project/vllm/pull/34571).

## Guide

> Background reference. Commands in it are examples and may target another configuration — use the Serve section above.

### Overview

[Qwen3.5-9B](https://huggingface.co/Qwen/Qwen3.5-9B) is a dense multimodal
model from the Qwen3.5 family — same gated delta networks hybrid attention,
vision encoder, 262K context, and MTP support as its larger siblings, but
sized to fit comfortably on a single 24 GB GPU.

### Prerequisites

- **vLLM version:** >= 0.17.0
- **Hardware:** single 24 GB GPU (RTX 4090 / L4 / A10G / H100) or Intel Arc Pro B60/B70

### Client Usage

```python
from openai import OpenAI

client = OpenAI(api_key="EMPTY", base_url="http://localhost:8000/v1")
# The server's model name is the checkpoint it runs: the selected variant's.
model = client.models.list().data[0].id
resp = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Hello!"}],
    max_tokens=128,
)
print(resp.choices[0].message.content)
```

Qwen3.5 thinks before it answers. To turn thinking off for one request, pass
`extra_body={"chat_template_kwargs": {"enable_thinking": False}}`; for every
request, start the server with
`--default-chat-template-kwargs '{"enable_thinking": false}'`.

### References

- [Model card](https://huggingface.co/Qwen/Qwen3.5-9B)
- [Base checkpoint](https://huggingface.co/Qwen/Qwen3.5-9B-Base)
