Skip to content

Swobu

LLM switchboard for Claude Code, Codex and AI agents — pool providers, cloud credits, regions and local models behind stable routes.

Install

$git clone https://github.com/swobuforge/swobu

Install command taken from the project's README or registry entry. Always review code before running it.

Swobu — LLM Switchboard

English · 简体中文 · 日本語 · Português (Brasil) · Bahasa Indonesia · 한국어 · Русский · Español · Українська

Pool LLM capacity you already have.

Put provider accounts, cloud regions, hosted endpoints, and local GPUs behind stable model names. Your agents keep one endpoint; Swobu handles routing, runtime fallback, and protocol translation underneath.

Documentation · Quickstart · VS Code · Releases

Compatibility shown, not partnership. Support varies by provider and runtime.


Install

macOS, Linux, or WSL:

curl -fsSL https://swobu.com/install.sh | sh

Windows PowerShell:

irm https://swobu.com/install.ps1 | iex

Cockpit opens after install. Add a provider, create a route, then connect an agent.

swobu connect claude
swobu connect codex

Muse, pi, Kilo, and Hermes are also supported. Certified with Antigravity CLI 1.2.3: run swobu connect antigravity --workspace <name>, open a new terminal, then run ordinary agy.

Build your first route in five minutes →


Route once. Change the capacity underneath.

A Swobu route looks like a model name to your agent. It is the stable name the agent already sends while Swobu owns the configured capacity behind it.

agent: model = coding
          │
          ▼
        Swobu
          │
          ├─ Azure AI / region A
          ├─ Azure AI / region B
          ├─ AWS Bedrock
          └─ Ollama

Routes can pool provider accounts, regions, hosted endpoints, local servers, and models. Peer target order changes across attempts; fallback tiers define what happens after a real attempt fails. Swobu does not inspect live quota, price, health, or latency.

Runtime fallback, not preflight. Swobu does not preflight compatibility. It sends the real request to the configured target, and a failed attempt can advance to the next target in the route.

Protocol translation at one boundary. Current protocol families include OpenAI Responses, OpenAI Chat Completions, Anthropic Messages, and Gemini Interactions. Translation occurs where the requested semantics are representable.

How routing works → · Capability matrix →


Share a route without sharing provider credentials

swobu share dev/coding

A Share gives the remote client an HTTPS endpoint and bearer. Provider keys remain on the machine running Swobu. You can change what backs the route without changing the remote configuration, then revoke access when you are done.

Application TLS terminates on the owner machine running Swobu; the relay forwards encrypted application traffic and does not terminate that TLS.

Workspace and Route Share →


Local-first

Similar plugs

Orca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies

Documented system prompts from Anthropic - Claude Fable 5.1, Opus 5.5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro,…

Wrap Antigravity, ChatGPT Codex, Claude Code, Grok Build, Muse Code, Devin as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini…