Python
feat: add OrcaRouter as a named model provider
XiaoHuo88838bbe717a3b0
diff --git a/README.md b/README.mdindex 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 anModel 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.pyindex 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 hidesshowing a made-up denominator. Values entered 2026-07-28 from vendor docs; verify alongsidethe 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 itsdescriptor in ``registry.py`` once the current provider surface is tested — deliberatelydeferred 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 thediff --git a/coworker/providers/registry.py b/coworker/providers/registry.pyindex 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 Noneif 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.pyindex 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.tsindex 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.tsxindex 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?: sark: { 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.tsindex 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.svgnew file mode 100644index 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.pyindex 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.pyindex 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_providerfrom 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_keycurated = models_for_provider(name)