Skip to content
Python

feat: add OrcaRouter as a named model provider

XiaoHuo88838bbe717a3b0
diff --git a/README.md b/README.md
index 8ce19139..73916283 100644
--- a/README.md
+++ b/README.md
@@ -87,7 +87,7 @@ Unattended runs never self-approve: their asks park in an inbox until a human an
Model access is yours: pick a provider, paste your key, switch anytime. Supported out of the box:
-**OpenAI · Anthropic · Google Gemini · BytePlus Ark · Volcengine Ark Agent Plan · Inkling (Thinking Machines) · GLM (Z.ai) · DeepSeek · Kimi (Moonshot) · Qwen · MiniMax · Mistral · Grok (xAI)** - plus open-weight models via **Together** and **Fireworks**, and fully local models via **Ollama**.
+**OpenAI · Anthropic · Google Gemini · BytePlus Ark · Volcengine Ark Agent Plan · Inkling (Thinking Machines) · GLM (Z.ai) · DeepSeek · Kimi (Moonshot) · Qwen · MiniMax · Mistral · Grok (xAI)** - plus aggregators **OrcaRouter** and **OpenRouter**, open-weight models via **Together** and **Fireworks**, and fully local models via **Ollama**.
A curated model list marks what we've verified for tool-calling work. Adding any model string works at your own risk.
diff --git a/coworker/providers/matrix.py b/coworker/providers/matrix.py
index 1d1ed5ee..4ce6c9cc 100644
--- a/coworker/providers/matrix.py
+++ b/coworker/providers/matrix.py
@@ -16,7 +16,7 @@ where the vendor spec wasn't re-checked stay ``None`` — the meter simply hides
showing a made-up denominator. Values entered 2026-07-28 from vendor docs; verify alongside
the id refresh.
-Resellers: Together + Fireworks + OpenRouter + Nebius. TODO: add Groq entries here AND its
+Resellers: Together + Fireworks + OpenRouter + Nebius + OrcaRouter. TODO: add Groq entries here AND its
descriptor in ``registry.py`` once the current provider surface is tested — deliberately
deferred to bound how much needs verifying at once.
"""
@@ -321,6 +321,15 @@ MATRIX: dict[str, ModelEntry] = {
"openrouter:stealth/ox-alpha": ModelEntry(
"Ox Alpha · via OpenRouter", _AGENTIC, 1_048_576
),
+ # OrcaRouter: the same vendor namespaces, one key for all of them (ids + context
+ # windows checked against their catalog/pricing API 2026-08-14).
+ "orcarouter:anthropic/claude-sonnet-5": ModelEntry(
+ "Claude Sonnet 5 · via OrcaRouter", _AGENTIC, 1_000_000
+ ),
+ "orcarouter:openai/gpt-5.5": ModelEntry("GPT-5.5 · via OrcaRouter", _AGENTIC),
+ "orcarouter:deepseek/deepseek-v4-pro": ModelEntry(
+ "DeepSeek V4 Pro · via OrcaRouter", _AGENTIC, 1_048_576
+ ),
# -- cloud accounts (models running in the user's own AWS/GCP) ----------------
# Bedrock ids carry a family segment (claude/ → native Anthropic path, other/ →
# Converse) plus AWS's own `-v<n>:<m>` version suffix. Some regions require the
diff --git a/coworker/providers/registry.py b/coworker/providers/registry.py
index e74dda94..c97d06c5 100644
--- a/coworker/providers/registry.py
+++ b/coworker/providers/registry.py
@@ -736,6 +736,14 @@ DESCRIPTORS: list[ProviderDescriptor] = [
recommended_model="zai-org/GLM-5.2",
env_key="NEBIUS_API_KEY",
),
+ _compat(
+ "orcarouter",
+ "OrcaRouter",
+ base_url="https://api.orcarouter.ai/v1",
+ recommended_model="anthropic/claude-sonnet-5",
+ env_key="ORCAROUTER_API_KEY",
+ endpoint_help="Keys start with sk-orca-; get one at orcarouter.ai.",
+ ),
ProviderDescriptor(
name="ollama",
title="Ollama",
@@ -857,6 +865,8 @@ def detect_provider(api_key: str) -> Optional[str]:
return None
if key.startswith("sk-ant-"):
return "anthropic"
+ if key.startswith("sk-orca-"):
+ return "orcarouter"
if key.startswith("sk-or-"):
return "openrouter"
if key.startswith("AIza"):
diff --git a/coworker/server/manager.py b/coworker/server/manager.py
index 4eecac05..7aaf6a1b 100644
--- a/coworker/server/manager.py
+++ b/coworker/server/manager.py
@@ -4272,6 +4272,11 @@ class SessionManager:
"qwen": ["qwen3-max", "qwen3-coder-plus", "qwen-plus"],
"xai": ["grok-4.3", "grok-4"],
"mistral": ["mistral-large-latest", "mistral-small-latest"],
+ "orcarouter": [
+ "anthropic/claude-sonnet-5",
+ "openai/gpt-5.5",
+ "deepseek/deepseek-v4-pro",
+ ],
}
def _suggested_models(self, name: str) -> list[str]:
diff --git a/surfaces/gui/src/api.ts b/surfaces/gui/src/api.ts
index 6b343639..18185e08 100644
--- a/surfaces/gui/src/api.ts
+++ b/surfaces/gui/src/api.ts
@@ -2763,6 +2763,7 @@ export function detectProvider(apiKey: string): string | null {
const key = (apiKey || "").trim();
if (!key) return null;
if (key.startsWith("sk-ant-")) return "anthropic";
+ if (key.startsWith("sk-orca-")) return "orcarouter";
if (key.startsWith("sk-or-")) return "openrouter";
if (key.startsWith("AIza")) return "gemini";
if (key.startsWith("sk-") || key.startsWith("sk_")) return "openai";
diff --git a/surfaces/gui/src/providers/ProviderSetup.tsx b/surfaces/gui/src/providers/ProviderSetup.tsx
index e1596237..74ebdbc6 100644
--- a/surfaces/gui/src/providers/ProviderSetup.tsx
+++ b/surfaces/gui/src/providers/ProviderSetup.tsx
@@ -37,6 +37,7 @@ export const KEY_HELP: Record<string, { url: string; label: string; labelKey?: s
ark: { url: "https://console.byteplus.com/ark/region:ark+ap-southeast-1/apiKey", label: "console.byteplus.com" },
"ark-agent-plan-cn": { url: "https://console.volcengine.com/ark/region:cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentPlan", label: "console.volcengine.com" },
openrouter: { url: "https://openrouter.ai/keys", label: "openrouter.ai" },
+ orcarouter: { url: "https://www.orcarouter.ai", label: "orcarouter.ai" },
bedrock: { url: "https://console.aws.amazon.com/bedrock/home#/api-keys", label: "the AWS Bedrock console", labelKey: "misc.provider.bedrock_console" },
fireworks: { url: "https://fireworks.ai/account/api-keys", label: "fireworks.ai" },
together: { url: "https://api.together.xyz/settings/api-keys", label: "together.xyz" },
diff --git a/surfaces/gui/src/providers/logos.ts b/surfaces/gui/src/providers/logos.ts
index fa670d7a..78e8112b 100644
--- a/surfaces/gui/src/providers/logos.ts
+++ b/surfaces/gui/src/providers/logos.ts
@@ -17,6 +17,7 @@ import vllm from "./logos/vllm.svg";
import bedrock from "./logos/bedrock.svg";
import vertex from "./logos/vertex.svg";
import openrouter from "./logos/openrouter.svg";
+import orcarouter from "./logos/orcarouter.svg";
import fireworks from "./logos/fireworks.svg";
import together from "./logos/together.svg";
import zai from "./logos/zai.svg";
@@ -47,6 +48,7 @@ export const PROVIDER_LOGOS: Record<string, string> = {
openrouter,
// Same mark for the signed-in OpenRouter provider: same models, billed to the account.
"openrouter-account": openrouter,
+ orcarouter,
fireworks,
together,
nebius,
@@ -73,6 +75,7 @@ export const PROVIDER_ORDER = [
"vertex",
"openrouter",
"openrouter-account",
+ "orcarouter",
"fireworks",
"together",
"zai",
diff --git a/surfaces/gui/src/providers/logos/orcarouter.svg b/surfaces/gui/src/providers/logos/orcarouter.svg
new file mode 100644
index 00000000..e39a4f8a
--- /dev/null
+++ b/surfaces/gui/src/providers/logos/orcarouter.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="1em" height="1em" style="flex:none;line-height:1"><title>OrcaRouter</title><path fill="#0160E6" d="M 0.00 0.00 C 7.92 0.00 15.84 0.00 24.00 0.00 C 24.00 7.92 24.00 15.84 24.00 24.00 C 16.08 24.00 8.16 24.00 0.00 24.00 C 0.00 16.08 0.00 8.16 0.00 0.00 Z M 16.02 4.71 C 15.92 5.26 15.92 5.26 15.92 5.63 C 15.69 5.58 15.69 5.58 15.18 5.40 C 14.04 5.21 12.54 5.48 11.95 6.65 C 12.00 6.83 12.00 6.83 12.05 6.88 C 12.35 6.86 12.65 6.85 12.95 6.84 C 13.29 6.83 13.29 6.83 13.62 6.85 C 14.25 6.89 14.88 6.87 15.51 6.86 C 16.30 6.90 17.08 8.35 17.26 9.09 C 17.08 9.09 16.90 9.09 16.71 9.09 C 16.62 9.18 16.62 9.18 16.66 9.46 C 16.92 9.90 17.19 10.21 17.58 10.52 C 17.42 11.50 16.55 12.01 15.65 12.14 C 15.09 12.09 15.09 12.09 14.77 11.95 C 14.72 11.63 14.72 11.63 14.82 11.40 C 14.82 11.12 14.82 11.12 14.68 10.98 C 14.01 10.98 13.55 11.10 12.92 11.31 C 12.19 11.36 11.71 11.06 11.10 10.68 C 10.99 10.61 10.89 10.55 10.78 10.48 C 10.73 10.45 10.73 10.45 10.48 10.29 C 8.87 9.31 7.18 8.44 5.28 8.27 C 4.84 8.21 4.48 8.09 4.06 7.94 C 3.41 7.94 3.03 8.02 2.82 8.68 C 2.82 8.77 2.82 8.86 2.82 8.95 C 3.00 9.00 3.00 9.00 3.23 8.86 C 4.91 8.86 6.21 10.83 7.02 12.09 C 7.21 12.25 7.41 12.41 7.62 12.55 C 7.96 12.90 8.07 13.15 8.26 13.62 C 8.58 13.94 8.58 13.94 8.99 14.21 C 10.21 15.02 10.68 16.08 10.94 17.49 C 10.66 17.87 10.14 17.71 9.75 17.56 C 9.64 17.51 9.53 17.45 9.42 17.40 C 9.26 17.35 9.10 17.29 8.94 17.24 C 8.52 17.09 8.15 16.94 7.80 16.66 C 7.66 16.59 7.53 16.51 7.38 16.43 C 7.23 16.29 7.08 16.16 6.92 16.02 C 6.89 16.02 6.86 16.02 6.83 16.02 C 6.83 15.98 6.83 15.95 6.83 15.92 C 6.69 15.83 6.56 15.74 6.42 15.65 C 6.14 15.46 6.14 15.46 6.05 15.32 C 6.02 15.32 5.99 15.32 5.95 15.32 C 5.95 15.30 5.95 15.30 5.91 15.18 C 5.82 15.12 5.72 15.06 5.63 15.00 C 5.55 14.94 5.48 14.88 5.40 14.82 C 5.37 14.82 5.34 14.82 5.31 14.82 C 5.31 14.78 5.31 14.75 5.31 14.72 C 5.26 14.72 5.22 14.72 5.17 14.72 C 5.26 14.91 5.26 14.91 5.40 15.05 C 5.51 15.17 5.61 15.29 5.72 15.42 C 6.21 15.88 6.21 15.88 6.32 15.88 C 6.32 16.11 6.32 16.11 6.14 16.20 C 5.01 17.06 4.02 18.36 3.88 19.80 C 4.20 20.45 4.89 20.35 5.53 20.25 C 7.01 19.92 8.22 19.00 9.14 17.82 C 9.37 17.89 9.60 17.98 9.83 18.06 C 10.86 18.44 10.86 18.44 11.42 18.54 C 11.97 18.69 12.18 19.06 12.55 19.48 C 14.05 20.84 16.43 21.83 18.37 20.86 C 18.55 20.63 18.55 20.63 18.55 20.31 C 18.21 19.84 17.80 19.52 17.34 19.17 C 16.60 18.59 16.60 18.59 16.66 18.42 C 16.84 18.34 17.03 18.26 17.22 18.18 C 20.03 16.94 21.53 14.04 21.12 11.03 C 20.58 8.91 19.41 7.41 17.45 6.46 C 17.08 6.28 17.08 6.28 16.98 6.18 C 17.03 6.00 17.03 6.00 17.40 5.58 C 17.87 4.76 18.08 3.74 17.77 2.82 C 16.89 2.82 16.29 4.01 16.02 4.71 Z M 4.98 14.49 C 5.08 14.68 5.08 14.68 5.17 14.72 C 5.08 14.49 5.08 14.49 4.98 14.49 Z"/></svg>
diff --git a/tests/test_provider_verify.py b/tests/test_provider_verify.py
index 625d23d7..39e0b3ae 100644
--- a/tests/test_provider_verify.py
+++ b/tests/test_provider_verify.py
@@ -15,6 +15,7 @@ from coworker.providers import detect_provider, verify_provider_key
"key,expected",
[
("sk-ant-api03-abc", "anthropic"),
+ ("sk-orca-v1-abc", "orcarouter"),
("sk-or-v1-abc", "openrouter"),
("AIzaSyAbc123", "gemini"),
("sk-proj-abc", "openai"),
@@ -99,6 +100,15 @@ def test_verify_openai_completions_route_404_is_clear(monkeypatch):
assert "v1" in res["error"]
+def test_verify_orcarouter_endpoint(monkeypatch):
+ cap: dict = {}
+ _patch_get(monkeypatch, status=200, capture=cap)
+ assert verify_provider_key("orcarouter", api_key="sk-orca-x") == {"ok": True}
+ # OpenAI-compatible branch: prefilled vendor endpoint, bearer key
+ assert cap["url"] == "https://api.orcarouter.ai/v1/models"
+ assert cap["headers"]["Authorization"] == "Bearer sk-orca-x"
+
+
def test_verify_bad_key_is_invalid(monkeypatch):
_patch_get(monkeypatch, status=401)
assert verify_provider_key("openai", api_key="sk-bad") == {
diff --git a/tests/test_providers.py b/tests/test_providers.py
index 5c2a10a2..ea91b9e0 100644
--- a/tests/test_providers.py
+++ b/tests/test_providers.py
@@ -288,6 +288,7 @@ COMPAT_VENDORS = {
"qwen": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
"xai": "https://api.x.ai/v1",
"mistral": "https://api.mistral.ai/v1",
+ "orcarouter": "https://api.orcarouter.ai/v1",
}
@@ -467,6 +468,7 @@ def test_compat_models_route_and_get_tool_capabilities():
"qwen:qwen3-max",
"xai:grok-4.3",
"mistral:mistral-large-latest",
+ "orcarouter:anthropic/claude-sonnet-5",
):
prefix = model.split(":", 1)[0]
assert router._provider_name(model) == prefix
@@ -499,6 +501,7 @@ def test_matrix_answers_capabilities_for_reseller_ids():
"openrouter:z-ai/glm-5.2",
"openrouter:meta-llama/llama-4-maverick",
"nebius:zai-org/GLM-5.2",
+ "orcarouter:anthropic/claude-sonnet-5",
):
caps = capabilities_for(mid)
assert caps.tools and caps.parallel_tool_calls and caps.streaming
@@ -565,7 +568,7 @@ def test_reseller_descriptors_and_matrix_stay_in_lockstep():
from coworker.providers.matrix import models_for_provider
from coworker.providers.registry import get_descriptor
- for name in ("together", "fireworks", "openrouter", "nebius"):
+ for name in ("together", "fireworks", "openrouter", "nebius", "orcarouter"):
d = get_descriptor(name)
assert d is not None and d.needs_key
curated = models_for_provider(name)