Switchyard¶
Switchyard routes and translates LLM traffic for coding agents and API clients. It supports OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages.
Choose a Path¶
| Goal | Path | Start here |
|---|---|---|
| Run Claude Code, Codex, or OpenClaw through Switchyard | Launcher Path | Install and launch an agent |
| Run Switchyard as a standalone proxy for API clients | Server Path | Build and run the Rust server |
| Add Switchyard routing to a Rust application | Library Path | switchyard-libsy |
The Launcher Path installs the switchyard CLI and hosts the native Rust server
through its packaged PyO3 binding. The Server Path builds and runs the
standalone switchyard-server binary.
Explore¶
- Core Concepts: learn the LLM client, target, and route layers
- Routing Algorithms: choose how requests select a model
- Architecture: understand the proxy and library components
- CLI Reference: inspect supported launcher commands and options
- Context-Window Handling: configure eviction and retry behavior
Reference¶
switchyard-server: server configuration, endpoints, and metricsswitchyard-libsy: embeddable routing algorithmsswitchyard-protocol: provider-neutral API typesswitchyard-translation: protocol translation