Signal-driven
Classify intent, safety, and domain signals — then route each request to the right model.
面向异构 LLM 推理的系统级智能
将信号与偏好转化为跨异构 LLM 的可执行模型路径。
Deploy fast, route by signal, and keep every decision observable.
Classify intent, safety, and domain signals — then route each request to the right model.
Deploy as Envoy ExtProc or local vllm-sr. No client changes for existing integrations.
From rules to reinforcement learning — every routing decision is configurable and measurable.
The decision engine classifies each request and picks the best model in your fleet. Clients keep the same OpenAI-compatible API.
Heterogeneous models
在四个维度上统一碎片化的模型生态。
了解工作原理不同模型擅长不同任务。
组合个性化模型路径。
GPU、加速 器、边缘与云端算力并存。
跨异构算力完成路由。
推理横跨边缘、私有环境与云端。
让数据始终留在边界之内。
“最佳”因用户与负载而变化。
让每一种偏好都可执行。
16 类信号,覆盖启发式与学习式检测,从知识库路由到历史感知 reask。
12 种路由策略,覆盖规则、时延启发式、强化学习与机器学习选择。
18 篇研究论文,覆盖路由、系统、安全与多模态。
路由蓝图
探索架构如何提取信号、组合决策并执行选定的模型路径。
从通信理论到路由流水线的结构映射。
用户请求是在编码前的原始源消息。
专用编码器在选择生成模型之前,先提取意图、上下文、安全与模态信号。
序列分类、token 标注、嵌入检索和重排序,最终汇合成同一层系统智能。
独立编码查询和候选项为稠密向量,用于相似度搜索和语义缓存。
联合交叉注意力评分查询-候选对,实现高精度重排序。
基于自研 BERT 的领域、越狱、PII 和事实核查的分类器,覆盖多个 signal
跨 token 和句子的双向注意力 — 双向完整上下文,非因果掩码。
推理时自适应调整嵌入层数和维度,按需平衡计算量与精度。
无需重训即可截断嵌入向量到任意维度 — 按请求平衡精度与速度。
只保留一条官方支持的本地启动路径:复制安装命令,执行后即可进入控制台。 首跑路径收敛为一个安装脚本,负责在 macOS 和 Linux 上配置 CLI 与本地服务流程。
Downloads the installer, prepares Docker, and writes vllm-sr to your PATH.
curl -fsSL https://vllm-semantic-router.com/zh-Hans/install.sh | bashRemoves ~/.local/share/vllm-sr and ~/.local/bin/vllm-sr. Stop any running serve session first.
rm -rf ~/.local/share/vllm-sr && rm -f ~/.local/bin/vllm-srSee how signals, policies, and models connect for every request.
Classify intent and complexity, then route each request to the best model in your fleet.
Combine embeddings, domain, PII, jailbreak, preference, and more into executable routing decisions.
Match prompts to model descriptions with embedding similarity for Cursor-style Auto routing.
Balance quality, latency, cost, and load without reading prompt content.
Chain lightweight models for triage and escalate hard prompts to frontier models.
Run on gateways, Kubernetes, or locally — with 16 signal families for every request.
Same router, any infrastructure
16 heuristic and learned detectors
从安全、多模态到编排与系统设计,这些研究线索持续塑造 vLLM Semantic Router 的演进方向。
vLLM Semantic Router Team
arXiv 技术报告
We introduce vLLM Semantic Router, a signal-driven decision routing framework for Mixture-of-Modality deployments that composes heterogeneous signals into deployment-specific routing policies across cost, privacy, latency, and safety constraints.
Huamin Chen, Xunzhuo Liu, Bowei He, Fuyuan Lyu, Yankai Chen, Xue Liu, Yuhan Liu, Junchen Jiang
arXiv 技术报告
We synthesize the project’s recent routing, fleet, multimodal, and governance results into the Workload-Router-Pool (WRP) architecture, connecting signal-driven routing to a full-stack inference optimization framework and outlining future research directions across workload, router, and pool design.
Xunzhuo Liu, Bowei He, Xue Liu, Andy Luo, Haichen Zhang, Huamin Chen
arXiv 技术报告
We formalize the visual confused deputy as a security failure mode in computer-using agents and introduce a dual-channel guardrail that independently checks click targets and action reasoning before execution.
Huamin Chen, Xunzhuo Liu, Junchen Jiang, Bowei He, Xue Liu
arXiv 技术报告
We introduce Outcome-Aware Tool Selection (OATS), an offline embedding refinement method that improves semantic-router tool ranking under single-digit millisecond CPU budgets without adding serving-time model inference.
Xunzhuo Liu, Bowei He, Xue Liu, Andy Luo, Haichen Zhang, Huamin Chen
arXiv 技术报告
We propose Adaptive VLM Routing (AVR), which estimates action difficulty and routes computer-use agent steps to the cheapest model that still satisfies a target reliability threshold.
Xunzhuo Liu, Bowei He, Xue Liu, Andy Luo, Haichen Zhang, Huamin Chen
arXiv 技术报告
We combine Flash Attention, prompt compression, and near-streaming body processing to cut routing latency from seconds to tens of milliseconds while keeping the router lightweight enough to share hardware with serving.
Huamin Chen, Xunzhuo Liu, Yuhan Liu, Junchen Jiang, Bowei He, Xue Liu
arXiv 技术报告
We present a queueing-theory-grounded fleet planner and discrete-event simulator for sizing multi-pool LLM GPU fleets against P99 TTFT targets, without requiring hardware profiling runs up front.
Huamin Chen, Xunzhuo Liu, Yuhan Liu, Junchen Jiang, Bowei He, Xue Liu
arXiv 技术报告
We derive the minimum-cost two-pool LLM fleet directly from the workload CDF and P99 TTFT target, then use Compress-and-Route to make the optimal boundary deployable in practice.
Huamin Chen, Xunzhuo Liu, Yuhan Liu, Junchen Jiang, Bowei He, Xue Liu
arXiv 技 术报告
We derive the 1/W law showing that tokens per watt roughly halve whenever the serving context window doubles, making context-length routing topology a larger energy-efficiency lever than a pure GPU generation upgrade.
Xunzhuo Liu, Hao Wu, Huamin Chen, Bowei He, Xue Liu
arXiv 技术报告
We show how probabilistic ML predicates in policy languages can silently co-fire on the same query, and implement conflict detection plus a softmax-based prevention mechanism in the Semantic Router DSL.
Huamin Chen, Xunzhuo Liu, Bowei He, Xue Liu
arXiv 技术报告
We extend the Semantic Router DSL from stateless, per-request routing to multi-step agent workflows, emitting verified decision nodes for orchestration frameworks, Kubernetes artifacts, YANG/NETCONF payloads, and protocol-boundary gates from a single declarative source file.
Xunzhuo Liu, Bowei He, Xue Liu, Andy Luo, Haichen Zhang, Huamin Chen
arXiv 技术报告
We show that conversational memory and retrieval-grounded routing let a lightweight 8B model recover most of a 235B model’s performance on persistent user-specific queries while cutting effective inference cost by 96%.
Xunzhuo Liu, Bowei He, Xue Liu, Haichen Zhang, Huamin Chen
SIGIR 2026 Industry Track
We present a real-time verification component for long-document RAG that processes contexts up to 32K tokens, balancing latency and grounding coverage so interactive systems can detect unsupported answers without falling back to truncated checks.
Huamin Chen, Xunzhuo Liu, Junchen Jiang, Bowei He, Xue Liu
arXiv 技术报告
We propose token-budget-aware pool routing, which estimates each request’s total token budget using a self-calibrating bytes-per-token ratio and dispatches it to short or long vLLM pools to cut fleet cost while avoiding KV-cache failures.
Chen Wang, Xunzhuo Liu, Yuhan Liu, Yue Zhu, Xiangxi Mo, Junchen Jiang, Huamin Chen
NeurIPS - MLForSys
We present a semantic router that classifies queries based on their reasoning requirements and selectively applies reasoning only when beneficial.
Chen Wang, Xunzhuo Liu, Yue Zhu, Alaa Youssef, Priya Nagpurkar, Huamin Chen
We present a category-aware semantic caching where similarity thresholds, TTLs, and quotas vary by query category, with a hybrid architecture separating in-memory HNSW search from external document storage.
Huamin Chen, Luay Jalil
互联网工程任务组(IETF)
This document specifies the Semantic Inference Routing Protocol (SIRP), a framework for content-level classification and semantic routing in AI inference systems.
H. Chen, L. Jalil, N. Cocker
Internet Engineering Task Force (IETF) - Network Management Research Group
This document specifies multi-provider extensions for agentic AI inference APIs. Published: 20 October 2025. Intended Status: Informational. Expires: 23 April 2026.
来自研究、基础设施与模型系统的维护者,共同塑造这个项目。
支撑 vLLM Semantic Router 的开源库与平台。
用信号、偏好与策略塑造每一条模型路径。