vLLM/Recipes
vLLM Semantic Router

vllm-sr/d3-edge

Decision 3.0's 0.6B decision model: answers typed questions (choice, yes / no, score) about text, JSON, images and videos with a probability for every option, without generating text.

MI300X: all 416 decisions match the checkpoint runtime; 2.3x its server's requests per second at 64 clients

dense0.59B262,144 ctxvLLM nightly+embeddingmultimodal
Guide

Overview

vllm-sr/d3-edge is the 0.6B model of Decision 3.0, the decision models of vLLM Semantic Router. Give it a state (text or JSON, optionally with images and videos) and typed questions: pick one of several options (choice), yes or no (noul), or a level on a scale (score). It returns a probability for every option, without generating text.

It is a backbone of the Qwen3.5 architecture (0.59B parameters, including the 0.10B vision encoder), trained from Qwen/Qwen3.5-0.8B, with an answer-code readout. vLLM detects the checkpoint's decision_config.json and serves it as a classification model (D3ForSequenceClassification) on its System One endpoint, /v1/systemone: one forward pass per question, whose readout scores that question's options at the last token. The full attention layers read the prompt in both directions, so chunked prefill and prefix caching are off.

The Decision 3.0 models, all served the same way:

Prerequisites

  • Hardware: one GPU. The BF16 weights take 1.2 GB; vLLM reserves 92 % of the GPU's memory by default.
  • vLLM: a nightly build. Decision 3.0 support (vllm-project/vllm#61565) is on vLLM main since 2026-10-14 and not in a release yet (the latest, v0.31.0, does not include it). Every nightly built since 2026-10-15 includes it.
  • ROCm: Python 3.12, glibc 2.39 or newer (for example Ubuntu 24.04), and the system libraries libopenmpi3t64 and libdw1t64, which the ROCm wheels load at import.
uv venv --python 3.12 --seed
source .venv/bin/activate

# NVIDIA GPUs (CUDA)
uv pip install -U vllm --torch-backend=auto --extra-index-url https://wheels.vllm.ai/nightly

# AMD GPUs (ROCm 7.2; glibc 2.39 or newer, as on Ubuntu 24.04)
sudo apt install -y libopenmpi3t64 libdw1t64
export VLLM_ROCM_VARIANT=$(curl -s https://wheels.vllm.ai/rocm/nightly | grep -oP 'rocm\d+' | head -1 | sed 's/%2B/+/g')
uv pip install --pre vllm --extra-index-url https://wheels.vllm.ai/rocm/nightly/${VLLM_ROCM_VARIANT} --index-strategy unsafe-best-match

Launch

vllm serve vllm-sr/d3-edge

No flags are needed; the first start downloads the model.

Client usage

The command builder's cURL and Bench buttons send chat completions, which a decision model does not serve. Ask questions on /v1/systemone instead:

curl -s localhost:8000/v1/systemone -H 'content-type: application/json' -d '{
  "model": "vllm-sr/d3-edge",
  "state": "Write a Python function that merges two sorted lists.",
  "questions": {
    "kind": {"type": "choice", "instructions": "What kind of work is this?",
             "criteria": {"code": "Writing or fixing code", "math": "Mathematics", "chat": "Anything else"}},
    "reasoning": {"type": "noul", "instructions": "Does answering this need multi-step reasoning?"}
  }
}'

Each answer carries the pick, the probability of every option, and confidence, the chosen option's probability; a noul answer's value is the probability of yes. The probabilities are the checkpoint runtime's (model.system_one()). Images and videos go in images and videos as http(s) or base64 data URLs; vLLM places them before the text and reads them with the runtime's budgets (images up to 1.6 megapixels; videos at 2 fps, at most 32 frames):

curl -s localhost:8000/v1/systemone -H 'content-type: application/json' --data-binary @- <<EOF
{
  "model": "vllm-sr/d3-edge",
  "state": "What does the attached image show?",
  "images": ["data:image/png;base64,$(base64 -w0 chart.png)"],
  "questions": {
    "kind": {"type": "choice", "instructions": "What kind of image is this?",
             "criteria": {"chart": "A chart or plot", "photo": "A photograph", "document": "A document"}}
  }
}
EOF

A request takes up to 64 questions; a choice up to 255 options; a score 2 to 10 levels. A top-level instructions field returns 400, since the prompt is fixed.

Measured

On one AMD Instinct MI300X (ROCm 7.2), in a new Ubuntu 24.04 environment with empty caches and the ROCm nightly 0.32.0rc1.dev190+g3f1bcfd82, against the checkpoint's own runtime (AutoModel.from_pretrained(..., trust_remote_code=True) with transformers 5.17.0 and flash-linear-attention 0.5.2) on 416 questions (text, JSON, a 40-option choice, an image and a video): no decision changed; the median probability difference was 0.0030 and the largest 0.034.

Closed loop over a mix of text, JSON, image and video requests (every image and video with new bytes), at 1, 8 and 64 concurrent clients: vLLM served 16.1, 72.0 and 61.5 requests per second, the checkpoint's own server (d3_server.py) 18.7, 36.5 and 26.9. From empty caches, vLLM gave its first answer 140 s after vllm serve started, the model download included.

Troubleshooting

  • libmpi_cxx.so.40 or libdw.so.1: cannot open shared object file when importing vLLM on ROCm: install libopenmpi3t64 and libdw1t64.
  • Python version on ROCm: the ROCm nightly wheels are built for Python 3.12 only (cp312); create the venv with --python 3.12, as above.

References