Note — This repository is just one of several download channels
and an issue tracker. For product information, announcements, and
commercial inquiries, visit echobird.ai.
💜 Sponsors
Sponsorship contact: [email protected]
What is EchoBird?
Friends kept asking me to install Claude Code, OpenClaw, Hermes Agent… every machine was different, and some refused to pay for an LLM. Setup and explanations took forever. So I built EchoBird — an Agent inspired by Songbird, the genius netrunner from Cyberpunk 2077 who solves any tech problem for V…
Highlights
EchoBird offers 4 scenarios sharing a unified model data hub — configure once, used everywhere.
4 scenarios
- Install & Repair Agent — let an AI install and fix mainstream tools (Claude Code, OpenClaw, Hermes Agent, …); works locally and remotely
- One-click local LLM — bundled vLLM / SGLang / llama.cpp runtimes; pick a quant, hit START
- Plugin Hub (Developer Preview) — install reviewed community plugins or add extensions from a repository or local directory
- App Manager — one-click launch and management for every AI / Agent app & game
Shared foundation
- Model Nexus — a unified data hub for OpenAI / Anthropic / local LLMs / API Routers; configure once and all 4 scenarios pick it up; one-click latency check before you commit
Cross-platform — Windows, macOS, Linux (x64 + arm64)
Multi-account switching — ChatGPT, Codex CLI, and Claude Code
Manage multiple saved accounts in EchoBird's App Manager, view their usage quota, and choose the account to use when launching a tool.
- ChatGPT desktop and Codex CLI — add OpenAI accounts through browser sign-in, then select a saved account and launch. Both tools share the local Codex account configuration, so switching affects the shared login.
- Claude Code — add accounts through browser authorization, select an account, and launch Claude Code with it. View the plan, remaining 5-hour and 7-day quota, and reset countdowns when available.
- Quota at a glance — check remaining quota and reset times, refresh account usage, and remove saved accounts from the same panel.
Get started: open App Manager → choose ChatGPT, Codex CLI, or Claude Code → add and authorize your accounts → select an account → launch. Account selection takes effect on launch; choose a third-party model instead when you want to use an API provider.
Multi-model smart routing — priority and automatic failover
EchoBird's Smart Router puts multiple model providers behind one local API. Add free, paid, or private models from Model Nexus, then drag the cards into your preferred order. The router tries models in that order and automatically falls back when a model is rate-limited, out of quota, or temporarily unavailable. After cooldown, it retries models in priority order.
- Up to 20 models — reuse your configured models without entering their API keys again.
- One endpoint for compatible tools — supports OpenAI Chat Completions and Anthropic Messages, including clients such as Claude Code.
- Explicit priority — you control the order; routing follows that order rather than selecting models by task or price.
Get started: open Smart Router → add models from My Models or the free-model directory → drag to set priority → choose Auto Router for a compatible tool in App Manager. Keep EchoBird running while tools use its local API.
Smart Router switches between configured model APIs; it does not automatically rotate saved login accounts. ChatGPT / Codex CLI third-party models require the Responses API, which Smart Router does not currently expose. For those tools, use account switching or a Responses-compatible provider directly.
Explore account switching and smart routing on the website.
Supported tools — install & switch models in one click
EchoBird bundles the install references and writes each tool's native config
file, so you install from one place and — crucially — switch the model
with a single click. Configure a provider once in Model Nexus, then point
any supported tool at it; no manual TOML / JSON editing, no per-CLI re-login.
This is the part most "model switcher" repos leave you to figure out alone.
One-click install + one-click model switch
The tools below support both — install and model switching — which is
the core of what EchoBird is for:
Coding CLIs — Claude Code · Codex CLI (OpenAI) · Grok Build (xAI) ·
Kimi CLI (Moonshot) · Qwen Code · Aider · OpenCode · MiMo Code (Xiaomi) · Kilo Code ·
ZCode (Z.AI) · OpenClaw · Pi · Vibe-Trading
Desktop apps — Claude Desktop (3P profile) · ChatGPT desktop ·
Kimi Desktop · OpenCode Desktop · OpenScience · WorkBuddy (Tencent CodeBuddy)
Searching GitHub for "switch model for Grok Build" or "switch model for
Kimi CLI or Kimi Desktop"? Those are first-class here — pick the model in Model Nexus,
hit switch, and EchoBird rewrites ~/.grok/config.toml or
~/.kimi-code/config.toml for you.
One-click install & launch
These are detected, installed, and managed by EchoBird, but model switching
is handled by the app itself (vendor-locked or no model config):
Hermes Desktop · Claude Science · Cursor · VS Code ·
Gemini Desktop · Coffee CLI
Screenshots
Model Nexus — the unified model data hub, configure once
App Desktop — one-click launch and management for every AI / Agent app
Local LLM — run models on your own machine
Install & Repair Agent — chat-driven setup and troubleshooting
My AI Career — dashboard
Install
One-line install
Windows (PowerShell)
irm https://echobird.ai/install.ps1 | iex
macOS / Linux
curl -fsSL https://echobird.ai/install.sh | sh
The script auto-detects your OS, downloads the right package, and skips if you're already on the latest version.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
