Teams running coding agents hit the same wall. Claude Code speaks the Anthropic Messages API, Codex CLI speaks OpenAI, and the model a team actually wants to serve sits behind vLLM, NVIDIA NIM, or Ollama. Rewriting the agent is not an option, so the translation layer has to live somewhere else.
Switchyard is NVIDIA’s answer: a Rust proxy and library for LLM traffic that routes requests across providers, translates between OpenAI and Anthropic formats, records operational metrics, and exposes typed, composable routing algorithms. It is released under Apache 2.0 with documentation at docs.nvidia.com/nemo/switchyard.
Is it deployable? Yes, but for evaluation only. The binary installs from crates.io and the launcher from PyPI, and it self-hosts anywhere, but NVIDIA labels Switchyard pre-alpha and experimental, warns it is not for production use, and expects the API and algorithms to change significantly before v1.0.
What Switchyard does
Clients keep their native API. Switchyard decodes the inbound request into provider-neutral Rust types, runs a routing algorithm to pick a backend, re-encodes the request in that backend’s own wire format, calls it, and translates the response, including streaming events, back into the shape the client expects.
The server accepts three inbound formats: OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages. Any of the three can address any route, and each configured LLM client selects one upstream format of its own. That decoupling is the point: the agent’s API and the backend’s API no longer have to match.
Three ways to run it
The launcher path targets coding agents. Install the published tool with uv tool install --python 3.12 "nemo-switchyard[cli]"
, then run switchyard launch claude
, switchyard launch codex
, or switchyard launch openclaw
against a packaged deployment or your own TOML file.
The server path installs the standalone proxy with cargo install --locked switchyard-server
, validates a config with --dry-run
, and serves on a host and port you choose.
The library path uses switchyard-libsy
, which embeds the routing algorithms in a Rust application without owning an HTTP stack. It never calls a model itself; the algorithm decides which target to use and hands every model call back to the caller.
Routing algorithms
A route is one client-visible model ID plus the algorithm behind it. The server supports:
sends every request to one target.passthrough
splits traffic across targets using optional relative weights, with an optional seed that reproduces the selection sequence. This is the A/B and cost-experiment path.random
calls a classifier target for a capability verdict, then routes to a weak or strong target.llm_classifier
base_threshold
is required;min_confidence
,capability_elevated_floor
, andsession_affinity
tune it, and anything the judge cannot decide falls through to the strong target. Settingmode = "escalation"
runs every turn on the weak tier first and lets a judge decide whether to rerun it on the strong tier.scores tool-result and agent-progress signals from recent turns to pick a capable or efficient target, avoiding an extra classifier call on most turns.stage_router
Strong, weak, capable, and efficient are roles inside a route, not fixed properties of a model. The same upstream model can serve different roles in different routes.
Observability
GET /metrics
returns Prometheus text from the server’s process-wide OpenTelemetry provider. The families cover requests, errors, model-call latency, full-turn latency, prompt, completion, cached, cache-creation, and reasoning tokens, and upstream HTTP attempts by outcome and code. A tier
label carries strong
or weak
for distinguishable classifier decisions, and classifier calls are excluded from those families.
The more interesting metric is switchyard_routing_overhead_ms
, which reports the algorithm’s run time minus the call that served the request. Classifier calls are not subtracted, so an LLM-classifier route reports its classification time here while passthrough
and random
report the sub-millisecond cost of picking a target. Buckets start at 0.1 ms. Separately, --routing-log-file
appends a JSON record per completed response, and GET /v1/routing/session-stats
returns per-session call and token totals from that log.
Configuration
A TOML deployment has three layers: llm_clients
define base URL, wire format, credential environment variable, and retry policy; targets
bind one upstream model ID to a client; routes
expose one client-visible model ID and its algorithm. Secrets never sit in the file, since api_key_env
only names an environment variable. max_retries
defaults to 2 and applies to transport failures, timeouts, HTTP 408/429, and 5xx responses.
Key Takeaways
- Switchyard is an Apache-2.0 Rust proxy and library that routes and translates LLM traffic.
- It bridges OpenAI Chat, OpenAI Responses, and Anthropic Messages in both directions, including streams.
- Four route types ship: passthrough, random, LLM-classifier, and signal-driven stage router.
- Prometheus metrics isolate routing overhead from model-call latency, per model and tier.
- It is pre-alpha and explicitly not for production, so treat it as an evaluation tool.
Check out the [ GitHub Repo](https://github.com/NVIDIA-NeMo/Switchyard) and
[. Also, feel free to follow us on](https://docs.nvidia.com/nemo/switchyard/home)
**Documentation****and don’t forget to join our**[Twitter](https://x.com/intent/follow?screen_name=marktechpost)
and Subscribe to
[150k+ML SubReddit](https://www.reddit.com/r/machinelearningnews/)**. Wait! are you on telegram?**
[our Newsletter](https://magic.beehiiv.com/v1/f5e63dd4-5653-4f09-83e2-321a8b1ba526?email={{email}})
now you can join us on telegram as well.Need to partner with us for promoting your GitHub Repo OR Hugging Face Page OR Product Release OR Webinar etc.? Connect with us
Michal Sutter is a data science professional with a Master of Science in Data Science from the University of Padova. With a solid foundation in statistical analysis, machine learning, and data engineering, Michal excels at transforming complex datasets into actionable insights.