Building Mixture-of-Models: The Next-Generation Model Architecture for Heterogeneous LLM Inference
Documentation | Playground | Blog | Publications | Hugging Face
We believe Mixture-of-Models is the next-generation model architecture for heterogeneous LLM inference.
That is why we built vLLM Semantic Router—to turn signals and preferences into executable model paths for every user, product, and workload.
| Dimension | Fragmented today | With vLLM SR |
|---|---|---|
| Models | Models specialize in different work. | Compose personalized model paths. |
| Compute | GPUs, accelerators, edge, and cloud coexist. | Route across heterogeneous compute. |
| Location | Inference spans edge, private, and cloud. | Keep data within its boundaries. |
| Preference | "Best" changes by user and workload. | Make every preference executable. |
curl -fsSL https://vllm-semantic-router.com/install.sh | bashFor platform notes, detailed setup options, and troubleshooting, see the Installation Guide.
Online playground credentials
- Username:
love@vllm-sr.ai - Password:
vllm-sr
- [2026/06/29] New Blog: Micro-Agent: Beat Frontier Models with Collaboration inside Model API
- [2026/06/16] New Blog: Beyond One Model: Fusion in vLLM Semantic Router
- [2026/06/05] v0.3 Released: vLLM Semantic Router v0.3 Themis: From Signals to Stateful Production Routing
Earlier announcements
- [2026/03/24] Vision Paper Released: The Workload-Router-Pool Architecture for LLM Inference Optimization
- [2026/03/10] v0.2 Released: vLLM Semantic Router v0.2 Athena Release
- [2026/02/27] White Paper Released: Signal Driven Decision Routing for Mixture-of-Modality Models
- [2026/01/05] Iris v0.1 Released: vLLM Semantic Router v0.1 Iris: The First Major Release
- [2025/12/16] Collaboration: AMD × vLLM Semantic Router: Building the System Intelligence Together
- [2025/12/15] New Blog: Token-Level Truth: Real-Time Hallucination Detection for Production LLMs
- [2025/11/19] New Blog: Signal-Decision Driven Architecture: Reshaping Semantic Routing at Scale
- [2025/11/03] Paper Published: Category-Aware Semantic Caching for Heterogeneous LLM Workloads
- [2025/10/27] New Blog: Scaling Semantic Routing with Extensible LoRA
- [2025/10/12] Paper Accepted: When to Reason: Semantic Router for vLLM
- [2025/10/08] Collaboration: vLLM Semantic Router with vLLM Production Stack Team.
- [2025/09/01] Released the project: vLLM Semantic Router: Next Phase in LLM inference.
More announcements are available on the Blog and Publications pages.
For questions, feedback, or to contribute, please join the #semantic-router channel in vLLM Slack.
We host community meetings on the first and third Tuesday of each month to sync with contributors across different time zones:
- First Tuesday of the month: 9:00-10:00 AM EST (accommodates US EST, EU, and Asia Pacific contributors)
- Third Tuesday of the month: 1:00-2:00 PM EST (accommodates US EST and California contributors)
- Meeting recordings: YouTube
If you want to contribute, start with CONTRIBUTING.md.
For repository-native development workflow and validation commands, use AGENTS.md as the entrypoint and docs/agent/README.md as the canonical index.
If you find Semantic Router helpful in your research or projects, please consider citing it:
@misc{semanticrouter2025,
title={vLLM Semantic Router},
author={vLLM Semantic Router Team},
year={2025},
howpublished={\url{https://github.com/vllm-project/semantic-router}},
}
We are grateful to our sponsors who support us:
AMD provides us with GPU resources and ROCm™ software for training and researching frontier router models, enhancing E2E testing, and building the online models playground.