Skip to content

Latest commit

 

History

2,358 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
vLLM Semantic Router

Make Your Mixture-of-Models Programmable.

Documentation | Playground | Blog | Publications | Hugging Face | Slack

vllm-project%2Fsemantic-router | Trendshift vllm-project%2Fsemantic-router | Trendshift

Main GitHub Release Go Ask DeepWiki


About

vLLM Semantic Router is a programmable routing layer for building Mixture-of-Models systems across heterogeneous LLM infrastructure. It evaluates request signals, user preferences, and application policies to select—or compose—the right model path for each request.

Use it to improve quality, cost, latency, privacy, and safety without hard-coding routing logic into applications.

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.

Explore how it works →

Getting Started

Install

curl -fsSL https://vllm-sr.ai/install.sh | bash -s -- --channel stable

For pip, uv, or agent-driven installation, see the Installation Guide.

Online playground

Try the online playground at https://app.vllm-sr.ai/playground.

Credentials:

  • Username: love@vllm-sr.ai
  • Password: vllm-sr-read

Latest News

Earlier announcements

More announcements are available on the Blog and Publications pages.

Community

For questions, feedback, or to contribute, please join the #semantic-router channel in vLLM Slack. Track contributors, workgroups, and weekly activity at community.vllm-sr.ai.

Community Meetings

We host two monthly community meetings across APAC and the Americas:

  • APAC-friendly meeting — second Wednesday of the month: 9:00-10:00 AM Singapore time (UTC+8; the same local time in Beijing)
  • Americas-friendly meeting — fourth Wednesday of the month: 8:00-9:00 PM Eastern Time (America/New_York) / 5:00-6:00 PM Pacific Time

Contributing

If you want to contribute, start with CONTRIBUTING.md.

For repository-native development workflow and validation commands, use AGENTS.md as the entrypoint and tools/agent/docs/README.md as the canonical index.

Citation

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}},
}

Sponsors

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.


About

A programmable Mixture-of-Models router for heterogeneous LLM inference

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

5.9k stars

Watchers

63 watching

Forks

Releases

Packages

Used by

Contributors

Languages