Migration Guides

Learn how to migrate your existing LLM routing solution to BitRouter with minimal disruption.

Migrate Quickly with Agent Skills

The fastest way to migrate is to let an agent do it for you. The BitRouter skill in Claude Code can detect your current configuration, rewrite your baseURL and API key, and validate the result automatically.

Install the agent skills package:

npx skills add BitRouterAI/agent-skills

Then describe what you're migrating from — for example: "migrate my OpenRouter setup to BitRouter". The agent handles the rest.

General Migration Guide

Regardless of your current provider, the core change is the same: point your existing OpenAI-compatible client at BitRouter by updating two values.

1. Update your base URL

# Cloud
https://api.bitrouter.ai/v1

# Self-hosted
http://localhost:8787/v1

2. Update your API key

BITROUTER_API_KEY=your-key-here

Set this as the bearer token (or the api_key field) wherever your current provider key lives.

3. Model names stay the same

BitRouter uses the same model IDs as OpenAI-compatible APIs (gpt-4o, claude-3-5-sonnet-20241022, etc.) — no renaming required.

4. Verify the switch

curl https://api.bitrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $BITROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "Hello"}]}'

For provider-specific steps and edge cases, see the guides below.

Available Migration Guides

Migrate from OpenRouter

Complete guide for teams using OpenRouter who want to switch to BitRouter for better performance, self-hosting options, and agent-native features.

Migrate from LiteLLM

Step-by-step migration from LiteLLM's Python SDK or Proxy Server to BitRouter's high-performance Rust binary with zero dependencies.

Why Migrate to BitRouter?

• Performance: <10ms routing overhead vs 25-100ms for alternatives
• Simplicity: Single binary, no databases or containers required
• Agent-Native: Built-in MCP/ACP gateway, guardrails, and skills
• Flexibility: Self-host or cloud, BYOK or pay-per-use
• Open Source: Apache 2.0 license, permissionless usage

Need Help?

• Join our Discord community for migration support
• Open an issue on GitHub
• Contact contact@bitrouter.ai for enterprise migrations