Skip to content
Python

Add Upstage (Solar) as an OpenAI-compatible model provider

Sung Kimd8ac7cefcf22
diff --git a/README.md b/README.md
index d53b5aa3..b5281a55 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 · Atlas Cloud · 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**.
+**OpenAI · Anthropic · Google Gemini · BytePlus Ark · Volcengine Ark Agent Plan · Atlas Cloud · Inkling (Thinking Machines) · GLM (Z.ai) · DeepSeek · Kimi (Moonshot) · Qwen · MiniMax · Mistral · Grok (xAI) · Solar (Upstage)** - 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/capabilities.py b/coworker/providers/capabilities.py
index 9c7e05e4..c3514148 100644
--- a/coworker/providers/capabilities.py
+++ b/coworker/providers/capabilities.py
@@ -65,11 +65,22 @@ def capabilities_for(model: str) -> ModelCapabilities:
tools=True, vision=False, parallel_tool_calls=False, streaming=True
)
- # OpenAI-compatible vendors (DeepSeek, Z AI/GLM, Kimi, MiniMax, Qwen, xAI/Grok, Mistral):
- # tool calling + streaming across their current lineups; vision left off until probed
- # per-model (several have vision variants, but the text flagships are what we suggest).
+ # OpenAI-compatible vendors (DeepSeek, Z AI/GLM, Kimi, MiniMax, Qwen, xAI/Grok, Mistral,
+ # Upstage/Solar): tool calling + streaming across their current lineups; vision left off
+ # until probed per-model (several have vision variants, but the text flagships are what
+ # we suggest).
if name.startswith(
- ("deepseek", "glm", "kimi", "minimax", "qwen", "grok", "mistral", "magistral")
+ (
+ "deepseek",
+ "glm",
+ "kimi",
+ "minimax",
+ "qwen",
+ "grok",
+ "mistral",
+ "magistral",
+ "solar",
+ )
):
return ModelCapabilities(
tools=True, vision=False, parallel_tool_calls=True, streaming=True
diff --git a/coworker/providers/matrix.py b/coworker/providers/matrix.py
index 436848c3..8f58c816 100644
--- a/coworker/providers/matrix.py
+++ b/coworker/providers/matrix.py
@@ -215,6 +215,8 @@ MATRIX: dict[str, ModelEntry] = {
"mistral:mistral-large-latest": ModelEntry(
"Mistral Large · Mistral", _AGENTIC, 128_000
),
+ "upstage:solar-open2": ModelEntry("Solar Open 2 · Upstage"),
+ "upstage:solar-pro3": ModelEntry("Solar Pro 3 · Upstage"),
# -- SambaNova ---------------------------------------------------------------
# SambaCloud's OpenAI-compatible API; ids and windows are the `context_length` values
# api.sambanova.ai/v1/models reports (keyless, read 2026-10-25). The two 128k rows are
diff --git a/coworker/providers/registry.py b/coworker/providers/registry.py
index c5ad26ad..47f42d8a 100644
--- a/coworker/providers/registry.py
+++ b/coworker/providers/registry.py
@@ -247,7 +247,7 @@ def _build_openrouter_account(profile: dict[str, Any], secrets: Any) -> Provider
def _openai_compat(vendor: str, default_base_url: str, env_key: Optional[str] = None):
"""Builder factory for vendors reached through their OpenAI-compatible API (Z AI, DeepSeek,
- Kimi, MiniMax, Qwen, xAI, Mistral, Novita). The key is resolved from the vendor's OWN
+ Kimi, MiniMax, Qwen, xAI, Mistral, Novita, Upstage). The key is resolved from the vendor's OWN
profile (or its env var) — deliberately NOT from the OpenAI env/SecretStore fallback, so a
configured OpenAI key is never silently sent to a different vendor's endpoint. Missing key ⇒
fail fast with a vendor-named error (these are only built on demand, when one of their models
@@ -717,6 +717,13 @@ DESCRIPTORS: list[ProviderDescriptor] = [
env_key="NOVITA_API_KEY",
endpoint_help="Prefilled with Novita's OpenAI-compatible endpoint; keep it unless you use a regional or proxy variant.",
),
+ _compat(
+ "upstage",
+ "Upstage (Solar)",
+ base_url="https://api.upstage.ai/v1",
+ recommended_model="solar-pro3",
+ env_key="UPSTAGE_API_KEY",
+ ),
# Resellers: many labs' models behind one key, using THEIR model namespaces (the curated
# ids + display labels live in providers/matrix.py). Groq was deferred on 2026-07-04 to
# bound how much needed verifying at once; it landed 2026-10-25 with verified rows.
diff --git a/coworker/server/manager.py b/coworker/server/manager.py
index 4cf70717..d73b417e 100644
--- a/coworker/server/manager.py
+++ b/coworker/server/manager.py
@@ -4279,6 +4279,7 @@ class SessionManager:
"nvidia/nemotron-3-ultra-550b-a55b",
],
"atlascloud": ["zai-org/glm-5.2"],
+ "upstage": ["solar-pro3", "solar-pro2", "solar-mini"],
}
def _suggested_models(self, name: str) -> list[str]:
diff --git a/surfaces/gui/src/providers/ProviderSetup.tsx b/surfaces/gui/src/providers/ProviderSetup.tsx
index 01933ecd..941799b9 100644
--- a/surfaces/gui/src/providers/ProviderSetup.tsx
+++ b/surfaces/gui/src/providers/ProviderSetup.tsx
@@ -54,6 +54,7 @@ export const KEY_HELP: Record<string, { url: string; label: string; labelKey?: s
sambanova: { url: "https://cloud.sambanova.ai/apis", label: "cloud.sambanova.ai" },
atlascloud: { url: "https://www.atlascloud.ai/console/api-keys", label: "atlascloud.ai" },
groq: { url: "https://console.groq.com/keys", label: "console.groq.com" },
+ upstage: { url: "https://console.upstage.ai/api-keys", label: "console.upstage.ai" },
};
export type Verify = { state: "idle" | "testing" | "ok" | "error"; msg?: string };
diff --git a/surfaces/gui/src/providers/logos.ts b/surfaces/gui/src/providers/logos.ts
index 3fd1d653..487bb314 100644
--- a/surfaces/gui/src/providers/logos.ts
+++ b/surfaces/gui/src/providers/logos.ts
@@ -34,6 +34,7 @@ import minimax from "./logos/minimax.svg";
import xai from "./logos/xai.svg";
import meta from "./logos/meta.svg";
import nebius from "./logos/nebius.svg";
+import upstage from "./logos/upstage.svg";
export const PROVIDER_LOGOS: Record<string, string> = {
anthropic,
@@ -69,6 +70,7 @@ export const PROVIDER_LOGOS: Record<string, string> = {
qwen,
minimax,
xai,
+ upstage,
};
export const PROVIDER_ORDER = [
@@ -101,6 +103,7 @@ export const PROVIDER_ORDER = [
"atlascloud",
"novita",
"groq",
+ "upstage",
];
export function providerRank(name: string): number {
diff --git a/surfaces/gui/src/providers/logos/upstage.svg b/surfaces/gui/src/providers/logos/upstage.svg
new file mode 100644
index 00000000..6cc5e5d3
--- /dev/null
+++ b/surfaces/gui/src/providers/logos/upstage.svg
@@ -0,0 +1 @@
+<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Upstage</title><path d="M19.763 0l-.373 1.297h2.594L22.354 0h-2.591zM16.192 2.27l-.376 1.298h5.52l.37-1.298h-5.514zM12.897 4.54l-.376 1.298h8.166l.37-1.298h-8.16zM2.85 6.81l-.377 1.298h17.565l.37-1.297H2.848zM3.884 9.081l-.376 1.297H19.39l.37-1.297H3.882zM4.088 24l.376-1.297H1.866L1.5 24h2.588zM7.662 21.73l.376-1.297H2.515L2.15 21.73h5.513zM10.957 19.459l.376-1.297h-8.17l-.366 1.297h8.16zM21.005 17.189l.376-1.297H3.812l-.366 1.297h17.559zM19.967 14.919l.376-1.297H4.461l-.366 1.297h15.872zM18.786 12.649l.376-1.297H4.26l-.366 1.297h14.893z" fill="url(#lobe-icons-upsate-_R_0_)"></path><defs><linearGradient gradientUnits="userSpaceOnUse" id="lobe-icons-upsate-_R_0_" x1="11.927" x2="11.927" y2="24"><stop offset="0" stop-color="#AEBCFE"></stop><stop offset="1" stop-color="#805DFA"></stop></linearGradient></defs></svg>
\ No newline at end of file
diff --git a/tests/test_providers.py b/tests/test_providers.py
index f5d0b16c..2a13ac9f 100644
--- a/tests/test_providers.py
+++ b/tests/test_providers.py
@@ -291,6 +291,7 @@ COMPAT_VENDORS = {
"mistral": "https://api.mistral.ai/v1",
"nvidia": "https://integrate.api.nvidia.com/v1",
"atlascloud": "https://api.atlascloud.ai/v1",
+ "upstage": "https://api.upstage.ai/v1",
}
@@ -472,6 +473,7 @@ def test_compat_models_route_and_get_tool_capabilities():
"mistral:mistral-large-latest",
"orcarouter:anthropic/claude-sonnet-5",
"atlascloud:zai-org/glm-5.2",
+ "upstage:solar-pro3",
):
prefix = model.split(":", 1)[0]
assert router._provider_name(model) == prefix