DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
Python ai-agentsai-tutorclawbotcli-tooldeepresearchinteractive-learninglearningmulti-agent-systemsrag
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.pyindex 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.pyindex 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.pyindex 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.pyindex 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.pyindex 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 Falseassert 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.pyindex 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.pyindex 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.pyindex 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 Nonemodel["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.pyindex 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.pyindex 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