Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)
Python
minor: Add Opper provider (#1860)
Felixf29cc304bff8
diff --git a/README.md b/README.mdindex 1185b3f7..7e1cdd62 100644--- a/README.md+++ b/README.md@@ -270,6 +270,7 @@ For another API endpoint, open **Providers → Custom providers → Add provider| [Cheaper Inference](https://cheaperinference.com/signup) | `CHEAPER_INFERENCE_API_KEY` | `cheaperinference/gpt-5.4-mini` || [OrcaRouter](https://www.orcarouter.ai/) | `ORCAROUTER_API_KEY` | `orcarouter/deepseek/deepseek-v4-flash-free` || [xKiro](https://xkiro.com/) | `XKIRO_API_KEY` | `xkiro/qwen/qwen3.7-flash:free` |+| [Opper](https://platform.opper.ai/) | `OPPER_API_KEY` | `opper/claude-sonnet-4-6` || [Ollama Cloud](https://ollama.com/settings/keys) | `OLLAMA_API_KEY` | `ollama_cloud/qwen3-coder:480b` || [LM Studio](https://lmstudio.ai/) | `LM_STUDIO_BASE_URL` | `lmstudio/<model-id>` || [llama.cpp](https://github.com/ggml-org/llama.cpp) | `LLAMACPP_BASE_URL` | `llamacpp/<model-id>` |diff --git a/smoke/lib/config.py b/smoke/lib/config.pyindex 8528a425..116c51eb 100644--- a/smoke/lib/config.py+++ b/smoke/lib/config.py@@ -83,6 +83,7 @@ PROVIDER_SMOKE_DEFAULT_MODELS: dict[str, str] = {"siliconflow": "siliconflow/Qwen/Qwen3-32B","nebius": "nebius/Qwen/Qwen3-30B-A3B","scaleway": "scaleway/deepseek/deepseek-v4-flash",+ "opper": "opper/claude-sonnet-4-6","chutes": "chutes/Qwen/Qwen3-32B-TEE","featherless": "featherless/Qwen/Qwen3-32B","sambanova": "sambanova/Meta-Llama-3.3-70B-Instruct",diff --git a/src/free_claude_code/api/admin_static/providers/SOURCES.md b/src/free_claude_code/api/admin_static/providers/SOURCES.mdindex 735fe4de..8cb7d53b 100644--- a/src/free_claude_code/api/admin_static/providers/SOURCES.md+++ b/src/free_claude_code/api/admin_static/providers/SOURCES.md@@ -44,6 +44,7 @@ The LLaMA.cpp icon comes from the upstream llama.cpp repository; its MIT license| `openrouter.svg` | https://unpkg.com/@lobehub/[email protected]/icons/openrouter.svg || `orcarouter.png` | https://www.orcarouter.ai/apple-touch-icon.png || `xkiro.png` | https://xkiro.com/images/logo/logo-xt-green.png |+| `opper.svg` | https://opper.ai/ (provided by Opper, single-colour `currentColor` mark) || `poolside-color.svg` | https://unpkg.com/@lobehub/[email protected]/icons/poolside-color.svg || `qwen-color.svg` | https://unpkg.com/@lobehub/[email protected]/icons/qwen-color.svg || `sambanova-color.svg` | https://unpkg.com/@lobehub/[email protected]/icons/sambanova-color.svg |diff --git a/src/free_claude_code/api/admin_static/providers/opper.svg b/src/free_claude_code/api/admin_static/providers/opper.svgnew file mode 100644index 00000000..c29effac--- /dev/null+++ b/src/free_claude_code/api/admin_static/providers/opper.svg@@ -0,0 +1,3 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 315 315" fill="currentColor">+ <path fill-rule="evenodd" clip-rule="evenodd" d="M159.78 315C71.53 315 0 244.49 0 157.5C0 -18.9499 159.78 0.650075 159.78 0.650075C159.78 87.2201 88.36 157.4 0.2 157.5C149.8 157.64 159.78 315 159.78 315ZM160.52 217.98C160.52 217.98 156.94 161.65 105.04 157.52C120.6 157.34 160.52 151.54 160.52 96.5601C160.52 151.54 200.44 157.34 216 157.52C164.1 161.63 160.52 217.98 160.52 217.98Z"/>+</svg>diff --git a/src/free_claude_code/config/admin/provider_manifest.py b/src/free_claude_code/config/admin/provider_manifest.pyindex df3afad2..341de97c 100644--- a/src/free_claude_code/config/admin/provider_manifest.py+++ b/src/free_claude_code/config/admin/provider_manifest.py@@ -224,6 +224,13 @@ _PROVIDER_FIELD_OVERRIDES: dict[str, ProviderFieldOverride] = {"and tool-capable models."),},+ "OPPER_API_KEY": {+ "label": "Opper API Key",+ "description": (+ "Opper gateway key for OpenAI-compatible chat, reasoning and "+ "tool-capable models across its EU-hosted model pools."+ ),+ },"SCW_SECRET_KEY": {"label": "Scaleway API Key","description": (diff --git a/src/free_claude_code/config/provider_catalog.py b/src/free_claude_code/config/provider_catalog.pyindex efd34ca7..85e6da80 100644--- a/src/free_claude_code/config/provider_catalog.py+++ b/src/free_claude_code/config/provider_catalog.py@@ -93,6 +93,8 @@ CHEAPERINFERENCE_DEFAULT_BASE = "https://api.cheaperinference.com/v1"ORCAROUTER_DEFAULT_BASE = "https://api.orcarouter.ai/v1"# xKiro OpenAI-compatible multi-provider gateway.XKIRO_DEFAULT_BASE = "https://api.xkiro.com/v1"+# Opper OpenAI-compatible Chat Completions gateway.+OPPER_DEFAULT_BASE = "https://api.opper.ai/v3/compat"# Agnes AI OpenAI-compatible Chat Completions API.AGNES_DEFAULT_BASE = "https://apihub.agnes-ai.com/v1"# ZenMux OpenAI-compatible Chat Completions gateway.@@ -752,6 +754,17 @@ PROVIDER_CATALOG: dict[str, ProviderDescriptor] = {default_base_url=XKIRO_DEFAULT_BASE,proxy_attr="xkiro_proxy",),+ "opper": ProviderDescriptor(+ provider_id="opper",+ display_name="Opper",+ website_url="https://opper.ai/",+ logo_filename="opper.svg",+ credential_env="OPPER_API_KEY",+ credential_url="https://platform.opper.ai/",+ credential_attr="opper_api_key",+ default_base_url=OPPER_DEFAULT_BASE,+ proxy_attr="opper_proxy",+ ),"ollama_cloud": ProviderDescriptor(provider_id="ollama_cloud",display_name="Ollama Cloud",diff --git a/src/free_claude_code/config/settings.py b/src/free_claude_code/config/settings.pyindex 6aa0d15d..f2c1a68d 100644--- a/src/free_claude_code/config/settings.py+++ b/src/free_claude_code/config/settings.py@@ -249,6 +249,11 @@ class Settings(BaseModel):default=None, validation_alias="XKIRO_API_KEY")+ # ==================== Opper (OpenAI-compatible) ====================+ opper_api_key: OptionalNonEmptyString = Field(+ default=None, validation_alias="OPPER_API_KEY"+ )+# ==================== Fireworks AI Config ====================fireworks_api_key: OptionalNonEmptyString = Field(default=None, validation_alias="FIREWORKS_API_KEY"@@ -581,6 +586,9 @@ class Settings(BaseModel):xkiro_proxy: OptionalNonEmptyString = Field(default=None, validation_alias="XKIRO_PROXY")+ opper_proxy: OptionalNonEmptyString = Field(+ default=None, validation_alias="OPPER_PROXY"+ )fireworks_proxy: OptionalNonEmptyString = Field(default=None, validation_alias="FIREWORKS_PROXY")diff --git a/src/free_claude_code/providers/credential_validation.py b/src/free_claude_code/providers/credential_validation.pyindex 6aac08a0..2b4d293e 100644--- a/src/free_claude_code/providers/credential_validation.py+++ b/src/free_claude_code/providers/credential_validation.py@@ -68,6 +68,7 @@ _MODELS = _list_field("data")# https://ai.google.dev/gemini-api/docs/generate-content/api-errors# https://github.com/nebius/nebius-physical-ai/blob/main/docs/workbench/token-factory.md# https://www.scaleway.com/en/docs/generative-apis/+# https://docs.opper.ai/build/chat/drop-in-sdks# https://vercel.com/docs/ai-gateway/sdks-and-apis/rest-api# https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hf_api.py# https://docs.cohere.com/reference/list-models@@ -113,6 +114,7 @@ _PROBES = (),_Probe("nebius", "/models", _MODELS, _AUTH_401),_Probe("scaleway", "/models", _MODELS, _AUTH_401),+ _Probe("opper", "/models", _MODELS, _AUTH_401),_Probe("vercel","/credits",diff --git a/src/free_claude_code/providers/openai_chat/profiles.py b/src/free_claude_code/providers/openai_chat/profiles.pyindex a5ea459c..f8015a3e 100644--- a/src/free_claude_code/providers/openai_chat/profiles.py+++ b/src/free_claude_code/providers/openai_chat/profiles.py@@ -774,6 +774,18 @@ OPENAI_CHAT_PROFILES: dict[str, OpenAIChatProfile] = {max_output_tokens_path=("max_output_tokens",),),),+ "opper": OpenAIChatProfile(+ _policy(+ "OPPER",+ ReasoningReplayMode.REASONING_CONTENT,+ default_max_tokens=ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS,+ ),+ NamedEffortReasoning(+ _LOW_MEDIUM_HIGH,+ enabled_value="medium",+ ),+ model_listing=OpenAIModelListing(path="/models"),+ ),"ollama_cloud": OpenAIChatProfile(_policy("OLLAMA_CLOUD",diff --git a/tests/contracts/test_provider_catalog_order.py b/tests/contracts/test_provider_catalog_order.pyindex 1667f336..fb340790 100644--- a/tests/contracts/test_provider_catalog_order.py+++ b/tests/contracts/test_provider_catalog_order.py@@ -61,6 +61,7 @@ _EXPECTED_PROVIDER_ORDER: tuple[str, ...] = ("cheaperinference","orcarouter","xkiro",+ "opper","ollama_cloud","lmstudio","llamacpp",diff --git a/tests/contracts/test_smoke_config.py b/tests/contracts/test_smoke_config.pyindex 11ecea5c..65f520c4 100644--- a/tests/contracts/test_smoke_config.py+++ b/tests/contracts/test_smoke_config.py@@ -60,6 +60,7 @@ def _settings(**overrides):"siliconflow_api_key": "","nebius_api_key": "","scw_secret_key": "",+ "opper_api_key": "","chutes_api_key": "","featherless_api_key": "","wandb_api_key": "",@@ -701,6 +702,23 @@ def test_scaleway_provider_smoke_uses_documented_agent_model(monkeypatch) -> Nonassert models[0].source == "provider_default"+def test_opper_provider_smoke_uses_documented_agent_model(monkeypatch) -> None:+ monkeypatch.delenv("FCC_SMOKE_MODEL_OPPER", raising=False)+ config = _smoke_config(+ settings=_settings(+ model="ollama/llama3.1",+ ollama_base_url="",+ opper_api_key="opper-key",+ )+ )++ models = config.provider_smoke_models()++ assert [model.provider for model in models] == ["opper"]+ assert models[0].full_model == "opper/claude-sonnet-4-6"+ assert models[0].source == "provider_default"++def test_featherless_provider_smoke_uses_documented_agent_model(monkeypatch) -> None:monkeypatch.delenv("FCC_SMOKE_MODEL_FEATHERLESS", raising=False)config = _smoke_config(diff --git a/tests/providers/test_credential_validation.py b/tests/providers/test_credential_validation.pyindex bc4d3c8e..0412c109 100644--- a/tests/providers/test_credential_validation.py+++ b/tests/providers/test_credential_validation.py@@ -41,6 +41,7 @@ CASES = [),("nebius", "https://api.tokenfactory.nebius.com/v1/models", {"data": []}, 401),("scaleway", "https://api.scaleway.ai/v1/models", {"data": []}, 401),+ ("opper", "https://api.opper.ai/v3/compat/models", {"data": []}, 401),("vercel","https://ai-gateway.vercel.sh/v1/credits",diff --git a/tests/providers/test_opper.py b/tests/providers/test_opper.pynew file mode 100644index 00000000..284eb627--- /dev/null+++ b/tests/providers/test_opper.py@@ -0,0 +1,243 @@+"""Tests for the Opper OpenAI-chat provider profile."""++from unittest.mock import AsyncMock++import httpx2+import pytest+from openai import AsyncOpenAI++from free_claude_code.application.model_metadata import ProviderModelInfo+from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS+from free_claude_code.config.provider_catalog import OPPER_DEFAULT_BASE+from free_claude_code.core.anthropic.models import MessagesRequest+from free_claude_code.core.json_types import JsonObject, JsonValue+from free_claude_code.core.reasoning import ReasoningEffort, ReasoningPolicy+from free_claude_code.providers.model_listing import ModelListResponseError+from free_claude_code.providers.openai_chat import OpenAIChatProvider+from free_claude_code.providers.openai_chat.profiles import OPENAI_CHAT_PROFILES+from tests.providers.support import (+ immediate_admission,+ make_provider_config,+ profiled_provider,+ reasoning_for,+)++_MODEL = "claude-sonnet-4-6"+++def opper_provider() -> OpenAIChatProvider:+ return profiled_provider(+ "opper",+ make_provider_config(+ api_key="test-opper-key",+ base_url=OPPER_DEFAULT_BASE,+ ),+ admission=immediate_admission(provider_name="opper", max_attempts=1),+ )+++def _request(**overrides: JsonValue) -> MessagesRequest:+ payload: JsonObject = {+ "model": _MODEL,+ "messages": [{"role": "user", "content": "Inspect the file."}],+ "tools": [+ {+ "name": "read_file",+ "description": "Read a file",+ "input_schema": {+ "type": "object",+ "properties": {"path": {"type": "string"}},+ "required": ["path"],+ },+ }+ ],+ }+ payload.update(overrides)+ return MessagesRequest.model_validate(payload)+++def test_constructs_standard_openai_chat_provider(+ opper_provider: OpenAIChatProvider,+) -> None:+ assert isinstance(opper_provider, OpenAIChatProvider)+ assert opper_provider._provider_name == "OPPER"+ assert opper_provider._api_key == "test-opper-key"+ assert opper_provider._base_url == OPPER_DEFAULT_BASE+++ "reasoning",+ [ReasoningPolicy.provider_default(), ReasoningPolicy.off()],+)+def test_default_and_off_reasoning_omit_effort_and_keep_standard_fields(+ opper_provider: OpenAIChatProvider,+ reasoning: ReasoningPolicy,+) -> None:+ body = opper_provider._chat._build_request_body(_request(), reasoning=reasoning)++ assert body["max_tokens"] == ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS+ assert body["model"] == _MODEL+ assert body["tools"][0]["function"]["name"] == "read_file"+ assert "reasoning" not in body+ assert "reasoning_effort" not in body+ assert "thinking" not in body+ assert "extra_body" not in body+++ ("reasoning", "expected"),+ (+ (ReasoningPolicy.on(), "medium"),+ (ReasoningPolicy.on(effort=ReasoningEffort.MINIMAL), "low"),+ (ReasoningPolicy.on(effort=ReasoningEffort.LOW), "low"),+ (ReasoningPolicy.on(effort=ReasoningEffort.MEDIUM), "medium"),+ (ReasoningPolicy.on(effort=ReasoningEffort.HIGH), "high"),+ (ReasoningPolicy.on(effort=ReasoningEffort.XHIGH), "high"),+ (ReasoningPolicy.on(effort=ReasoningEffort.MAX), "high"),+ ),+)+def test_reasoning_maps_efforts_onto_documented_vocabulary(+ opper_provider: OpenAIChatProvider,+ reasoning: ReasoningPolicy,+ expected: str,+) -> None:+ body = opper_provider._chat._build_request_body(_request(), reasoning=reasoning)++ assert body["reasoning_effort"] == expected+++def test_replays_reasoning_content_with_tool_history(+ opper_provider: OpenAIChatProvider,+) -> None:+ request = _request(+ messages=[+ {"role": "user", "content": "Inspect the file."},+ {+ "role": "assistant",+ "content": [+ {"type": "thinking", "thinking": "Read it first."},+ {"type": "text", "text": "I will inspect it."},+ {+ "type": "tool_use",+ "id": "toolu_1",+ "name": "read_file",+ "input": {"path": "example.py"},+ },+ ],+ },+ {+ "role": "user",+ "content": [+ {+ "type": "tool_result",+ "tool_use_id": "toolu_1",+ "content": "print('hello')",+ }+ ],+ },+ ]+ )++ body = opper_provider._chat._build_request_body(+ request,+ reasoning=reasoning_for(request),+ )++ assert body["messages"][1] == {+ "role": "assistant",+ "content": "I will inspect it.",+ "reasoning_content": "Read it first.",+ "tool_calls": [+ {+ "id": "toolu_1",+ "type": "function",+ "function": {+ "name": "read_file",+ "arguments": '{"path": "example.py"}',+ },+ }+ ],+ }+ assert body["messages"][2] == {+ "role": "tool",+ "tool_call_id": "toolu_1",+ "content": "print('hello')",+ }+++async def test_model_catalog_returns_pool_ids(+ opper_provider: OpenAIChatProvider,+) -> None:+ opper_provider._client.get = AsyncMock(+ return_value={"data": [{"id": "gpt-5.5"}, {"id": _MODEL}]}+ )++ assert await opper_provider.list_model_infos() == frozenset(+ {ProviderModelInfo("gpt-5.5"), ProviderModelInfo(_MODEL)}+ )+++async def test_model_catalog_returns_route_pinned_ids(+ opper_provider: OpenAIChatProvider,+) -> None:+ opper_provider._client.get = AsyncMock(+ return_value={"data": [{"id": "azure/gpt-5.5"}, {"id": _MODEL}]}+ )++ assert await opper_provider.list_model_infos() == frozenset(+ {ProviderModelInfo("azure/gpt-5.5"), ProviderModelInfo(_MODEL)}+ )+++async def test_model_catalog_rejects_missing_id(+ opper_provider: OpenAIChatProvider,+) -> None:+ opper_provider._client.get = AsyncMock(return_value={"data": [{}]})++ with pytest.raises(ModelListResponseError, match="include id"):+ await opper_provider.list_model_infos()+++async def test_model_catalog_rejects_empty_catalog(+ opper_provider: OpenAIChatProvider,+) -> None:+ opper_provider._client.get = AsyncMock(return_value={"data": []})++ with pytest.raises(ModelListResponseError, match="did not include any model ids"):+ await opper_provider.list_model_infos()+++async def test_model_catalog_uses_documented_url_and_bearer_auth() -> None:+ requests: list[httpx2.Request] = []++ def handler(request: httpx2.Request) -> httpx2.Response:+ requests.append(request)+ return httpx2.Response(200, json={"data": [{"id": _MODEL}]})++ async with AsyncOpenAI(+ api_key="wire-opper-key",+ base_url=OPPER_DEFAULT_BASE,+ max_retries=0,+ http_client=httpx2.AsyncClient(transport=httpx2.MockTransport(handler)),+ ) as client:+ opper_provider = OpenAIChatProvider(+ make_provider_config(+ api_key="wire-opper-key",+ base_url=OPPER_DEFAULT_BASE,+ ),+ profile=OPENAI_CHAT_PROFILES["opper"],+ admission=immediate_admission(provider_name="opper"),+ client=client,+ )+ model_infos = await opper_provider.list_model_infos()++ assert model_infos == frozenset({ProviderModelInfo(_MODEL)})+ assert len(requests) == 1+ assert str(requests[0].url) == "https://api.opper.ai/v3/compat/models"+ assert requests[0].headers["authorization"] == "Bearer wire-opper-key"diff --git a/tests/providers/test_provider_runtime.py b/tests/providers/test_provider_runtime.pyindex 85aafe54..e38de52c 100644--- a/tests/providers/test_provider_runtime.py+++ b/tests/providers/test_provider_runtime.py@@ -27,6 +27,7 @@ from free_claude_code.config.provider_catalog import (MINIMAX_DEFAULT_BASE,NEBIUS_DEFAULT_BASE,OLLAMA_CLOUD_DEFAULT_BASE,+ OPPER_DEFAULT_BASE,ORCAROUTER_DEFAULT_BASE,POOLSIDE_DEFAULT_BASE,PROVIDER_CATALOG,@@ -100,6 +101,7 @@ def _make_settings(**overrides):mock.siliconflow_api_key = "test_siliconflow_key"mock.nebius_api_key = "test_nebius_key"mock.scw_secret_key = "test_scw_key"+ mock.opper_api_key = "test_opper_key"mock.chutes_api_key = "test_chutes_key"mock.featherless_api_key = "test_featherless_key"mock.mistral_api_key = "test_mistral_key"@@ -193,6 +195,7 @@ def _make_settings(**overrides):mock.siliconflow_proxy = Nonemock.nebius_proxy = Nonemock.scw_proxy = None+ mock.opper_proxy = Nonemock.chutes_proxy = Nonemock.featherless_proxy = Nonemock.azure_openai_proxy = None@@ -640,6 +643,32 @@ async def test_scaleway_provider_config_uses_key_base_and_proxy() -> None:assert isinstance(provider, OpenAIChatProvider)+async def test_opper_provider_config_uses_key_base_and_proxy() -> None:+ descriptor = PROVIDER_CATALOG["opper"]+ settings = _make_settings(+ opper_api_key="opper-token",+ opper_proxy="http://proxy.test:8080",+ )++ config = build_provider_config(descriptor, settings)+ with patch("free_claude_code.providers.openai_chat.client.AsyncOpenAI"):+ provider = await create_provider(+ "opper",+ settings,+ ProviderAdmissionRegistry(ProviderAdmissionLimits.from_settings(settings)),+ )++ assert descriptor.display_name == "Opper"+ assert descriptor.credential_env == "OPPER_API_KEY"+ assert descriptor.credential_url == "https://platform.opper.ai/"+ assert descriptor.base_url_attr is None+ assert config.api_key == "opper-token"+ assert config.base_url == OPPER_DEFAULT_BASE+ assert config.proxy == "http://proxy.test:8080"+ assert isinstance(provider, OpenAIChatProvider)++@pytest.mark.asyncioasync def test_chutes_provider_config_uses_key_base_and_proxy() -> None:descriptor = PROVIDER_CATALOG["chutes"]@@ -1117,6 +1146,7 @@ async def test_create_provider_instantiates_each_builtin():"siliconflow": OpenAIChatProvider,"nebius": OpenAIChatProvider,"scaleway": OpenAIChatProvider,+ "opper": OpenAIChatProvider,"chutes": OpenAIChatProvider,"featherless": OpenAIChatProvider,"azure_openai": OpenAIChatProvider,