Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

feat: add Opper as an LLM and embedding provider (#1786)

Felix4b6cddbe496f
diff --git a/deeptutor/services/config/embedding_endpoint.py b/deeptutor/services/config/embedding_endpoint.py
index b61c17def..679698041 100644
--- a/deeptutor/services/config/embedding_endpoint.py
+++ b/deeptutor/services/config/embedding_endpoint.py
@@ -102,6 +102,7 @@ EMBEDDING_PROVIDER_LABELS = {
"gemini": "Gemini",
"openrouter": "OpenRouter",
"orcarouter": "OrcaRouter",
+ "opper": "Opper",
"jina": "Jina",
"vllm": "vLLM / LM Studio",
"lemonade": "Lemonade Server",
@@ -115,6 +116,7 @@ EMBEDDING_PROVIDER_DEFAULT_ENDPOINTS = {
"gemini": gemini_embedding_endpoint(GEMINI_DEFAULT_EMBEDDING_MODEL),
"openrouter": "https://openrouter.ai/api/v1/embeddings",
"orcarouter": "https://api.orcarouter.ai/v1/embeddings",
+ "opper": "https://api.opper.ai/v3/compat/embeddings",
"cohere": "https://api.cohere.com/v2/embed",
"jina": "https://api.jina.ai/v1/embeddings",
"ollama": "http://localhost:11434/api/embed",
@@ -131,6 +133,7 @@ EMBEDDING_PROVIDERS_REQUIRING_EMBEDDINGS_PATH = {
"openai",
"openrouter",
"orcarouter",
+ "opper",
"jina",
"vllm",
"lemonade",
diff --git a/deeptutor/services/config/provider_runtime.py b/deeptutor/services/config/provider_runtime.py
index cb9234302..511c2100e 100644
--- a/deeptutor/services/config/provider_runtime.py
+++ b/deeptutor/services/config/provider_runtime.py
@@ -293,6 +293,15 @@ EMBEDDING_PROVIDERS: dict[str, EmbeddingProviderSpec] = {
default_model="openai/text-embedding-3-large",
default_dim=3072,
),
+ "opper": EmbeddingProviderSpec(
+ label="Opper",
+ adapter="openai_compat",
+ default_api_base=EMBEDDING_PROVIDER_DEFAULT_ENDPOINTS["opper"],
+ keywords=("opper",),
+ is_local=False,
+ default_model="text-embedding-3-large",
+ default_dim=3072,
+ ),
}
diff --git a/deeptutor/services/provider_registry.py b/deeptutor/services/provider_registry.py
index ab069a340..5c9fab5af 100644
--- a/deeptutor/services/provider_registry.py
+++ b/deeptutor/services/provider_registry.py
@@ -343,6 +343,16 @@ PROVIDERS: tuple[ProviderSpec, ...] = (
detect_by_base_keyword="futureinfra",
default_api_base="https://futureinfra.ai/v1/ai",
),
+ ProviderSpec(
+ name="opper",
+ keywords=("opper",),
+ env_key="OPPER_API_KEY",
+ display_name="Opper",
+ backend="openai_compat",
+ is_gateway=True,
+ detect_by_base_keyword="api.opper.ai",
+ default_api_base="https://api.opper.ai/v3/compat",
+ ),
ProviderSpec(
name="y_api",
keywords=("y_api", "y-api", "yapi"),
diff --git a/deeptutor/services/rag/pipelines/graphrag/config.py b/deeptutor/services/rag/pipelines/graphrag/config.py
index baaca45ce..454da01a0 100644
--- a/deeptutor/services/rag/pipelines/graphrag/config.py
+++ b/deeptutor/services/rag/pipelines/graphrag/config.py
@@ -67,6 +67,7 @@ OPENAI_COMPATIBLE_EMBEDDING_BINDINGS = frozenset(
"jina",
"openai",
"openrouter",
+ "opper",
"orcarouter",
"siliconflow",
"vllm",
diff --git a/tests/api/test_settings_router.py b/tests/api/test_settings_router.py
index c140deb45..443a4e78a 100644
--- a/tests/api/test_settings_router.py
+++ b/tests/api/test_settings_router.py
@@ -1905,3 +1905,10 @@ async def test_voice_math_speak_persists_without_freezing_defaults(
loaded = settings_router.load_ui_settings()
assert loaded["voice_math_speak"] is False
assert loaded["voice_autoplay"] is False
+
+
+def test_llm_provider_choices_include_opper() -> None:
+ llm = {item["value"]: item for item in settings_router._provider_choices()["llm"]}
+
+ assert llm["opper"]["label"] == "Opper"
+ assert llm["opper"]["base_url"] == "https://api.opper.ai/v3/compat"
diff --git a/tests/core/test_agentic_client_provider_kwargs.py b/tests/core/test_agentic_client_provider_kwargs.py
index acb299d9b..0cf8690e1 100644
--- a/tests/core/test_agentic_client_provider_kwargs.py
+++ b/tests/core/test_agentic_client_provider_kwargs.py
@@ -561,6 +561,7 @@ def test_registered_cloud_openai_compat_providers_enable_native_tools() -> None:
"api_route",
"requesty",
"futureinfra",
+ "opper",
"y_api",
"edenai",
"novita",
diff --git a/tests/services/config/test_embedding_runtime.py b/tests/services/config/test_embedding_runtime.py
index 7b8e408b5..002d2dced 100644
--- a/tests/services/config/test_embedding_runtime.py
+++ b/tests/services/config/test_embedding_runtime.py
@@ -282,6 +282,33 @@ def test_embedding_orcarouter_binding_uses_default_endpoint() -> None:
assert resolved.dimension == 3072
+def test_embedding_opper_binding_uses_default_endpoint() -> None:
+ catalog = _build_catalog(
+ embedding_profile={
+ "id": "embedding-p",
+ "name": "Embedding",
+ "binding": "opper",
+ "base_url": "",
+ "api_key": "opper-key",
+ "api_version": "",
+ "extra_headers": {},
+ "models": [
+ {
+ "id": "embedding-m",
+ "name": "opper",
+ "model": "text-embedding-3-large",
+ "dimension": "3072",
+ }
+ ],
+ }
+ )
+ resolved = resolve_embedding_runtime_config(catalog=catalog)
+ assert resolved.provider_name == "opper"
+ assert resolved.provider_mode == "standard"
+ assert resolved.effective_url == "https://api.opper.ai/v3/compat/embeddings"
+ assert resolved.dimension == 3072
+
+
def test_embedding_runtime_preserves_api_key_array() -> None:
catalog = _build_catalog(
embedding_profile={
diff --git a/tests/services/config/test_provider_runtime.py b/tests/services/config/test_provider_runtime.py
index 34c5a335d..d0b3e23e9 100644
--- a/tests/services/config/test_provider_runtime.py
+++ b/tests/services/config/test_provider_runtime.py
@@ -1114,3 +1114,54 @@ def test_old_adopted_fallback_is_not_a_model_capacity():
assert resolve_llm_runtime_config(catalog=catalog).context_window is None
model["context_window_source"] = "manual"
assert resolve_llm_runtime_config(catalog=catalog).context_window == 16384
+
+
+def test_llm_opper_binding_uses_default_openai_compatible_endpoint() -> None:
+ catalog = _build_catalog(
+ llm_profile={
+ "id": "llm-p",
+ "name": "Opper",
+ "binding": "opper",
+ "base_url": "",
+ "api_key": "opper-key",
+ "api_version": "",
+ "extra_headers": {},
+ "models": [
+ {
+ "id": "llm-m",
+ "name": "Claude Sonnet 4.6",
+ "model": "claude-sonnet-4-6",
+ }
+ ],
+ }
+ )
+
+ resolved = resolve_llm_runtime_config(catalog=catalog)
+
+ assert resolved.provider_name == "opper"
+ assert resolved.provider_mode == "gateway"
+ assert resolved.binding == "opper"
+ assert resolved.model == "claude-sonnet-4-6"
+ assert resolved.api_key == "opper-key"
+ assert resolved.effective_url == "https://api.opper.ai/v3/compat"
+
+
+def test_llm_opper_base_url_detection_preserves_openai_binding_compatibility() -> None:
+ catalog = _build_catalog(
+ llm_profile={
+ "id": "llm-p",
+ "name": "OpenAI Compatible",
+ "binding": "openai",
+ "base_url": "https://api.opper.ai/v3/compat",
+ "api_key": "opper-key",
+ "api_version": "",
+ "extra_headers": {},
+ "models": [{"id": "llm-m", "name": "GPT", "model": "gpt-5.4-mini"}],
+ }
+ )
+
+ resolved = resolve_llm_runtime_config(catalog=catalog)
+
+ assert resolved.provider_name == "opper"
+ assert resolved.provider_mode == "gateway"
+ assert resolved.effective_url == "https://api.opper.ai/v3/compat"
diff --git a/tests/services/rag/test_graphrag_pipeline.py b/tests/services/rag/test_graphrag_pipeline.py
index 7510ed5e2..106113884 100644
--- a/tests/services/rag/test_graphrag_pipeline.py
+++ b/tests/services/rag/test_graphrag_pipeline.py
@@ -226,6 +226,7 @@ def test_build_settings_preserves_embedding_request_options(
),
("openrouter", "https://openrouter.ai/api/v1/embeddings", "https://openrouter.ai/api/v1"),
("orcarouter", "https://api.orcarouter.ai/v1/embeddings", "https://api.orcarouter.ai/v1"),
+ ("opper", "https://api.opper.ai/v3/compat/embeddings", "https://api.opper.ai/v3/compat"),
("vllm", "http://localhost:8000/v1/embeddings", "http://localhost:8000/v1"),
("jina", "https://api.jina.ai/v1/embeddings", "https://api.jina.ai/v1"),
("custom", "https://gateway.test/v1/embeddings", "https://gateway.test/v1"),
diff --git a/tests/services/test_provider_registry.py b/tests/services/test_provider_registry.py
index bd7b95de2..473909fc1 100644
--- a/tests/services/test_provider_registry.py
+++ b/tests/services/test_provider_registry.py
@@ -121,6 +121,22 @@ def test_futureinfra_provider_aliases_and_base_detection() -> None:
assert find_gateway(api_base="https://futureinfra.ai/v1/ai") == spec
+def test_opper_provider_lookup_and_base_detection() -> None:
+ spec = find_by_name("opper")
+
+ assert spec is not None
+ assert spec.display_name == "Opper"
+ assert spec.env_key == "OPPER_API_KEY"
+ assert spec.backend == "openai_compat"
+ assert spec.mode == "gateway"
+ assert spec.default_api_base == "https://api.opper.ai/v3/compat"
+ assert find_by_name("Opper") == spec
+ assert find_gateway(api_base="https://api.opper.ai/v3/compat") == spec
+ # Detection keys on the API host, so a base URL that merely contains
+ # "opper" (e.g. a self-hosted "copper" endpoint) is not claimed.
+ assert find_gateway(api_base="https://llm.copper.example/v1") is None
+
+
def test_openai_codex_is_not_detected_from_api_base() -> None:
assert find_gateway(api_base="https://codex.example.com/v1") is None