Repolode
vllm-project

vllm-project/semantic-router

Uma camada de decisão aberta e programável que seleciona ou combina LLMs para cada solicitação, em backends locais, privados e na nuvem, usando um único endpoint de API.

Estrelas
6,412
Forks
1,111
Issues abertas
878
Último commit
há 7 horas

O que é?

O vLLM Semantic Router fica entre um agente ou aplicativo e um conjunto de backends de modelos. Em vez de enviar todas as chamadas para um único modelo, ele oferece um endpoint de inferência único (por exemplo, o ID de modelo público vllm-sr/auto) e decide, a cada chamada, qual modelo configurado — ou combinação de modelos — deve responder, com base nas políticas definidas pelo operador.

A política de roteamento abrange prioridades de qualidade, latência e custo, além dos locais onde as chamadas podem ser executadas, como edge, ambiente privado ou computação na nuvem. O harness do agente mantém seu próprio loop, ferramentas e estado da tarefa; o roteador cuida apenas da seleção de modelos e backends. O instalador, o playground e as coleções de modelos do Hugging Face fazem parte das ferramentas publicadas pelo projeto.

O projeto é escrito principalmente em Go e se destina a equipes que executam vários LLMs e querem configurar as decisões de roteamento em vez de deixá-las codificadas no código do aplicativo. Ele é licenciado sob Apache-2.0 e inclui tópicos relacionados ao Kubernetes nos metadados do repositório.

Recursos principais

  • 01Oferece um único endpoint de inferência que roteia solicitações entre vários modelos configurados.
  • 02Seleciona ou combina modelos a cada chamada, com base em políticas definidas pelo operador.
  • 03Permite que prioridades de qualidade, latência e custo orientem as decisões de roteamento.
  • 04Mantém as chamadas nos locais aprovados, entre edge, ambientes privados e computação na nuvem.
  • 05Oferece uma coleção de modelos de roteamento no Hugging Face (séries Decision e Vela).

Casos de uso

  • Direcionar um harness de agente para diferentes modelos, conforme a dificuldade ou o custo da tarefa.
  • Manter solicitações confidenciais em ambientes privados ou on-premises e enviar as demais para modelos na nuvem.
  • Executar uma configuração de mixture-of-models em vários backends servidos pelo vLLM, por trás de um único endpoint.

Início rápido

  1. 1

    Execute o script oficial de instalação do README

  2. 2

    Aponte seu agent harness para o endpoint do Router usando o model ID `vllm-sr/auto`

  3. 3

    Se quiser, experimente o playground online

Tópicos

Perguntas frequentes

O que é semantic-router?
Uma camada de decisão aberta e programável que seleciona ou combina LLMs para cada solicitação, em backends locais, privados e na nuvem, usando um único endpoint de API. O vLLM Semantic Router fica entre um agente ou aplicativo e um conjunto de backends de modelos. Em vez de enviar todas as chamadas para um único modelo, ele oferece um endpoint de inferência único (por exemplo, o ID de modelo público vllm-sr/auto) e decide, a cada chamada, qual modelo configurado — ou combinação de modelos — deve responder, com base nas políticas definidas pelo operador.
semantic-router é gratuito? Qual é a licença?
semantic-router é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
semantic-router ainda é mantido?
Manutenção ativa. O último commit de semantic-router foi em 6 de nov. de 2026.
Para que posso usar semantic-router?
Direcionar um harness de agente para diferentes modelos, conforme a dificuldade ou o custo da tarefa. Manter solicitações confidenciais em ambientes privados ou on-premises e enviar as demais para modelos na nuvem. Executar uma configuração de mixture-of-models em vários backends servidos pelo vLLM, por trás de um único endpoint.
Como instalar semantic-router?
Execute o script oficial de instalação do README Aponte seu agent harness para o endpoint do Router usando o model ID `vllm-sr/auto` Se quiser, experimente o playground online
Onde consigo semantic-router?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/vllm-project/semantic-router

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados