cd /news/large-language-models/shepherd-model-gateway-model-routing… · home topics large-language-models article
[ARTICLE · art-74681] src=github.com ↗ pub= topic=large-language-models verified=true sentiment=↑ positive

Shepherd Model Gateway – Model-routing gateway for LLM deployments

LightSeek Org released Shepherd Model Gateway (SMG), an engine-agnostic, high-performance model-routing gateway for large-scale LLM deployments that centralizes worker lifecycle management and balances traffic across HTTP, gRPC, and OpenAI-compatible backends. The gateway supports cache-aware routing for vLLM, TensorRT-LLM, TokenSpeed, and SGLang, offers multi-tenant rate limiting with OIDC and WebAssembly plugins, and provides 40+ Prometheus metrics with OpenTelemetry tracing. SMG is available via Docker, pip, and cargo, and can be run with a single command to point at inference workers.

read2 min views1 publishedJul 26, 2026
Shepherd Model Gateway – Model-routing gateway for LLM deployments
Image: source

Engine-agnostic, high-performance model-routing gateway for large-scale LLM deployments. Centralizes worker lifecycle management, balances traffic across HTTP/gRPC/OpenAI-compatible backends, and provides enterprise-ready control over history storage, MCP tooling, and privacy-sensitive workflows.

🚀 Maximize GPU Utilization | Cache-aware routing understands your inference engine's KV cache state—whether vLLM, TensorRT-LLM, TokenSpeed, or SGLang—to reuse prefixes and reduce redundant computation. | 🔌 One API, Any Backend | Route to self-hosted models (vLLM, TensorRT-LLM, TokenSpeed, SGLang) or cloud providers (OpenAI, Anthropic, Gemini, Bedrock, and more) through a single unified endpoint. | ⚡ Built for Speed | Native Rust with gRPC pipelines, sub-millisecond routing decisions, and zero-copy tokenization. Circuit breakers and automatic failover keep things running. | 🔒 Enterprise Control | Multi-tenant rate limiting with OIDC, WebAssembly plugins for custom logic, and a privacy boundary that keeps conversation history within your infrastructure. | 📊 Full Observability | 40+ Prometheus metrics, OpenTelemetry tracing, and structured JSON logs with request correlation—know exactly what's happening at every layer. |

API Coverage: OpenAI Chat/Completions/Embeddings, Responses API for agents, Anthropic Messages, and MCP tool execution.

Install — pick your preferred method:

docker pull lightseekorg/smg:latest

pip install smg

cargo install smg

Run — point SMG at your inference workers:

smg launch --worker-urls http://localhost:8000

smg launch --worker-urls http://gpu1:8000 http://gpu2:8000 --policy cache_aware

smg launch --worker-urls http://gpu1:8000 --enable-mesh \
  --mesh-advertise-host 10.0.0.1 --mesh-peer-urls 10.0.0.2:39527

Use — send requests to the gateway:

curl http://localhost:30000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model": "llama3", "messages": [{"role": "user", "content": "Hello!"}]}'

That's it. SMG is now load-balancing requests across your workers.

Self-Hosted Cloud Providers
vLLM OpenAI
TensorRT-LLM Anthropic
TokenSpeed Google Gemini
SGLang AWS Bedrock
Ollama Azure OpenAI
Any OpenAI-compatible server Any OpenAI-compatible provider
Feature Description
cache_aware, round_robin, power_of_two, consistent_hashing, prefix_hash, manual, random, bucket
Native gRPC with streaming, reasoning extraction, and tool call parsing
Connect external tool servers via Model Context Protocol
Mesh networking with SWIM protocol for multi-node deployments
Pluggable storage: PostgreSQL, Oracle, Redis, or in-memory
Extend with custom WebAssembly logic
Circuit breakers, retries with backoff, rate limiting

|

ArchitectureConfigurationAPI ReferenceKubernetes SetupWe welcome contributions! See Contributing Guide for details.

── more in #large-language-models 4 stories · sorted by recency
── more on @lightseek org 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
Live at https://your-agent.zahid.host
Get free account → Pricing
from €0/mo · no card required
LIVE [news/shepherd-model-gatew…] indexed:0 read:2min 2026-07-26 ·