PassingRight Docs
Migrations

Migrate from LiteLLM

Switch from self-hosted LiteLLM to managed PassingRight. Same API format, zero infrastructure to maintain.

Running your own LiteLLM proxy works—until it doesn't. Scaling, monitoring, and keeping it running becomes another job. PassingRight gives you the same unified API with built-in analytics, caching, and a dashboard—without the infrastructure overhead.

Let your AI agent do the migration

Copy this prompt into Claude Code, Cursor, or any coding agent — it reads our docs and handles the migration from LiteLLM for you.

Quick Migration

Both services use OpenAI-compatible endpoints, so migration is a two-line change:

- const baseURL = "http://localhost:4000/v1";  // LiteLLM proxy
+ const baseURL = "https://api.passingright.io/v1";

- const apiKey = process.env.LITELLM_API_KEY;
+ const apiKey = process.env.LLM_GATEWAY_API_KEY;

Why Teams Switch to PassingRight

What You GetLiteLLM (Self-Hosted)PassingRight
OpenAI-compatible APIYesYes
Infrastructure to manageYes (you run it)No (we run it)
Managed cloud optionNoYes
Analytics dashboardBasicPer-request detail
Response cachingManual setupBuilt-in, automatic
Cost trackingVia callbacksNative, real-time
Provider key managementConfig fileWeb UI with rotation
Uptime & scalingYou handle it99.9% SLA (managed)

Self-hosting also means you own the patch cycle. On March 24, 2026 two malicious litellm releases (1.82.7 and 1.82.8) reached PyPI and were pulled after about 40 minutes; they harvested credentials from unpinned pip installs, while pinned Docker deployments were unaffected. Pin versions wherever you self-host — PassingRight included — or use the managed gateway and skip the upkeep.

Still want to self-host? PassingRight is open source under AGPLv3—same features, your infrastructure.

For a detailed breakdown, see PassingRight vs LiteLLM.

Migration Steps

Get Your PassingRight API Key

Sign up at passingright.io/signup and create an API key from your dashboard.

Map Your Models

PassingRight supports two model ID formats:

Canonical Model IDs (without provider prefix) - Uses smart routing to automatically select the best provider based on uptime, throughput, price, and latency:

gpt-6-astra
claude-sonnet-5
gemini-3.1-pro-preview

Provider-Prefixed Model IDs - Routes to a specific provider with automatic failover if uptime drops below 90%:

openai/gpt-6-astra
anthropic/claude-sonnet-5
google-ai-studio/gemini-3.1-pro-preview

This means many LiteLLM model names work directly with PassingRight:

LiteLLM ModelPassingRight Model
gpt-6-astragpt-6-astra or openai/gpt-6-astra
anthropic/claude-sonnet-5claude-sonnet-5 or anthropic/claude-sonnet-5
gemini/gemini-3.1-pro-previewgemini-3.1-pro-preview or google-ai-studio/gemini-3.1-pro-preview
bedrock/anthropic.claude-sonnet-5claude-sonnet-5 or aws-bedrock/claude-sonnet-5

For more details on routing behavior, see the routing documentation.

Update Your Code

Python with OpenAI SDK

from openai import OpenAI

# Before (LiteLLM proxy)
client = OpenAI(
    base_url="http://localhost:4000/v1",
    api_key=os.environ["LITELLM_API_KEY"]
)

response = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[{"role": "user", "content": "Hello!"}]
)

# After (PassingRight) - model name can stay the same!
client = OpenAI(
    base_url="https://api.passingright.io/v1",
    api_key=os.environ["LLM_GATEWAY_API_KEY"]
)

response = client.chat.completions.create(
    model="gpt-6-astra",  # or "openai/gpt-6-astra" to target a specific provider
    messages=[{"role": "user", "content": "Hello!"}]
)

Python with LiteLLM Library

If you're using the LiteLLM library directly, you can point it to PassingRight:

import litellm

# Before (direct LiteLLM)
response = litellm.completion(
    model="gpt-6-astra",
    messages=[{"role": "user", "content": "Hello!"}]
)

# After (via PassingRight) - same model name works
response = litellm.completion(
    model="gpt-6-astra",  # or "openai/gpt-6-astra" to target a specific provider
    messages=[{"role": "user", "content": "Hello!"}],
    api_base="https://api.passingright.io/v1",
    api_key=os.environ["LLM_GATEWAY_API_KEY"]
)

TypeScript/JavaScript

import OpenAI from "openai";

// Before (LiteLLM proxy)
const client = new OpenAI({
	baseURL: "http://localhost:4000/v1",
	apiKey: process.env.LITELLM_API_KEY,
});

// After (PassingRight) - same model name works
const client = new OpenAI({
	baseURL: "https://api.passingright.io/v1",
	apiKey: process.env.LLM_GATEWAY_API_KEY,
});

const completion = await client.chat.completions.create({
	model: "gpt-6-astra", // or "openai/gpt-6-astra" to target a specific provider
	messages: [{ role: "user", content: "Hello!" }],
});

cURL

# Before (LiteLLM proxy)
curl http://localhost:4000/v1/chat/completions \
  -H "Authorization: Bearer $LITELLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# After (PassingRight) - same model name works
curl https://api.passingright.io/v1/chat/completions \
  -H "Authorization: Bearer $LLM_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
# Use "openai/gpt-6-astra" to target a specific provider

Migrate Configuration

LiteLLM Config (Before)

# litellm_config.yaml
model_list:
  - model_name: gpt-6-astra
    litellm_params:
      model: openai/gpt-6-astra
      api_key: sk-...
  - model_name: claude-sonnet-5
    litellm_params:
      model: anthropic/claude-sonnet-5
      api_key: sk-ant-...

PassingRight (After)

With PassingRight, you don't need a config file. Provider keys are managed in the web dashboard, or you can use the default PassingRight keys.

If you want to use your own provider keys, configure them in the dashboard under Settings > Provider Keys.

Streaming Support

PassingRight supports streaming identically to LiteLLM:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.passingright.io/v1",
    api_key=os.environ["LLM_GATEWAY_API_KEY"]
)

stream = client.chat.completions.create(
    model="openai/gpt-6-astra",
    messages=[{"role": "user", "content": "Write a story"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Function/Tool Calling

PassingRight supports function calling:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.passingright.io/v1",
    api_key=os.environ["LLM_GATEWAY_API_KEY"]
)

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get the weather for a location",
        "parameters": {
            "type": "object",
            "properties": {
                "location": {"type": "string"}
            },
            "required": ["location"]
        }
    }
}]

response = client.chat.completions.create(
    model="openai/gpt-6-astra",
    messages=[{"role": "user", "content": "What's the weather in Tokyo?"}],
    tools=tools
)

Removing LiteLLM Infrastructure

After verifying PassingRight works for your use case, you can decommission your LiteLLM proxy:

  1. Update all clients to use PassingRight endpoints
  2. Monitor the PassingRight dashboard for successful requests
  3. Shut down your LiteLLM proxy server
  4. Remove LiteLLM configuration files

What Changes After Migration

  • No servers to babysit — We handle scaling, uptime, and updates
  • Real-time cost visibility — See what every request costs, broken down by model
  • Automatic caching — Repeated requests hit cache, reducing your spend
  • Web-based management — No more editing YAML files for config changes
  • New models immediately — Access new releases within 48 hours, no deployment needed

Self-Hosting PassingRight

If you prefer self-hosting like LiteLLM, PassingRight is available under AGPLv3:

git clone https://github.com/theopenco/llmgateway
cd llmgateway
pnpm install
pnpm run setup
pnpm dev

This gives you the same benefits as LiteLLM's self-hosted proxy with PassingRight's analytics and caching features.

Full Comparison

Want to see a detailed breakdown of all features? Check out our PassingRight vs LiteLLM comparison page.

How is this guide?

Last updated on

On this page

Ready for production?

Ship to production with SSO, audit logs, spend controls, and guardrails your security team will approve.

Explore Enterprise