Skip to content

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

fix(embedding): support keyless Lemonade profiles (#1568)

Bingxi Zhao (Frank)d431b0036978
diff --git a/deeptutor/services/config/embedding_endpoint.py b/deeptutor/services/config/embedding_endpoint.py
index 6c155c8e8..10dab12f4 100644
--- a/deeptutor/services/config/embedding_endpoint.py
+++ b/deeptutor/services/config/embedding_endpoint.py
@@ -104,6 +104,7 @@ EMBEDDING_PROVIDER_LABELS = {
"orcarouter": "OrcaRouter",
"jina": "Jina",
"vllm": "vLLM / LM Studio",
+ "lemonade": "Lemonade Server",
"siliconflow": "SiliconFlow",
"ollama": "Ollama",
"cohere": "Cohere",
@@ -118,6 +119,7 @@ EMBEDDING_PROVIDER_DEFAULT_ENDPOINTS = {
"jina": "https://api.jina.ai/v1/embeddings",
"ollama": "http://localhost:11434/api/embed",
"vllm": "http://localhost:8000/v1/embeddings",
+ "lemonade": "http://localhost:13305/v1/embeddings",
"siliconflow": "https://api.siliconflow.cn/v1/embeddings",
"aliyun": (
"https://dashscope.aliyuncs.com/api/v1/services/embeddings/"
@@ -131,6 +133,7 @@ EMBEDDING_PROVIDERS_REQUIRING_EMBEDDINGS_PATH = {
"orcarouter",
"jina",
"vllm",
+ "lemonade",
"siliconflow",
}
diff --git a/deeptutor/services/config/provider_runtime.py b/deeptutor/services/config/provider_runtime.py
index 4b7778b57..634d5c1d3 100644
--- a/deeptutor/services/config/provider_runtime.py
+++ b/deeptutor/services/config/provider_runtime.py
@@ -223,6 +223,13 @@ EMBEDDING_PROVIDERS: dict[str, EmbeddingProviderSpec] = {
keywords=("vllm", "lmstudio"),
is_local=True,
),
+ "lemonade": EmbeddingProviderSpec(
+ label="Lemonade Server",
+ mode="local",
+ default_api_base=EMBEDDING_PROVIDER_DEFAULT_ENDPOINTS["lemonade"],
+ keywords=("lemonade",),
+ is_local=True,
+ ),
"siliconflow": EmbeddingProviderSpec(
label="SiliconFlow",
adapter="openai_compat",
@@ -1021,6 +1028,19 @@ def _resolve_embedding_provider(
api_base: str | None,
provider_pool: dict[str, NormalizedProviderConfig],
) -> str:
+ if api_base:
+ # Older keyless Lemonade profiles were saved as generic OpenAI
+ # Compatible embeddings. Recognize its known endpoint before a Qwen3
+ # model name is mistaken for a remote embedding vendor (#1568).
+ try:
+ endpoint = urlparse(api_base if "://" in api_base else f"http://{api_base}")
+ lemonade_endpoint = endpoint.port == 13305 and endpoint.path.rstrip("/").endswith(
+ ("/v1/embeddings", "/api/v1/embeddings")
+ )
+ except ValueError:
+ lemonade_endpoint = False
+ if lemonade_endpoint and hint in {None, "custom"}:
+ return "lemonade"
if hint and hint in EMBEDDING_PROVIDERS:
return hint
@@ -1062,7 +1082,7 @@ def resolve_embedding_runtime_config(
resolved_model = _as_str((model or {}).get("model"))
if not resolved_model:
raise ValueError(
- "No active embedding model is configured. Please set it in Settings > Catalog."
+ "No active embedding model is configured. Set it in Settings > Embedding models."
)
binding_hint_raw = _as_str((profile or {}).get("binding"))
diff --git a/deeptutor/services/embedding/config.py b/deeptutor/services/embedding/config.py
index 956bde19a..3b43abbd9 100644
--- a/deeptutor/services/embedding/config.py
+++ b/deeptutor/services/embedding/config.py
@@ -83,7 +83,7 @@ def get_embedding_config(
)
if not resolved.model:
- raise ValueError("Embedding model not set. Please configure it in Settings > Catalog.")
+ raise ValueError("Embedding model not set. Configure it in Settings > Embedding models.")
if not resolved.effective_url:
raise ValueError(
@@ -92,7 +92,8 @@ def get_embedding_config(
if resolved.provider_mode != "local" and not resolved.api_key:
raise ValueError(
- "Embedding API key not set. Please configure the active profile in Settings > Catalog."
+ "Embedding API key not set. Configure the active profile in "
+ "Settings > Embedding models."
)
return EmbeddingConfig(
diff --git a/tests/services/config/test_embedding_runtime.py b/tests/services/config/test_embedding_runtime.py
index da2d0745a..bc621b51b 100644
--- a/tests/services/config/test_embedding_runtime.py
+++ b/tests/services/config/test_embedding_runtime.py
@@ -4,10 +4,12 @@ from __future__ import annotations
import pytest
+from deeptutor.services.config.embedding_endpoint import normalize_embedding_endpoint_for_display
from deeptutor.services.config.provider_runtime import (
EMBEDDING_PROVIDERS,
resolve_embedding_runtime_config,
)
+from deeptutor.services.embedding.config import get_embedding_config
NATIVE_GEMINI2_ENDPOINT = (
"https://generativelanguage.googleapis.com/v1beta/models/gemini-embedding-2:batchEmbedContents"
@@ -76,6 +78,89 @@ def test_embedding_explicit_binding_and_headers() -> None:
assert resolved.dimension == 1024
+def test_lemonade_embedding_is_local_even_for_qwen_model_and_docker_hostname() -> None:
+ catalog = _build_catalog(
+ embedding_profile={
+ "id": "embedding-p",
+ "name": "Lemonade Server",
+ "binding": "lemonade",
+ "base_url": "http://lemonade:13305/api/v1/embeddings",
+ "api_key": "",
+ "models": [
+ {
+ "id": "embedding-m",
+ "name": "Qwen3",
+ "model": "Qwen3-Embedding-0.6B-GGUF",
+ }
+ ],
+ }
+ )
+
+ resolved = resolve_embedding_runtime_config(catalog=catalog)
+ assert resolved.provider_name == "lemonade"
+ assert resolved.provider_mode == "local"
+ assert resolved.api_key == ""
+ assert get_embedding_config(catalog=catalog).effective_url == (
+ "http://lemonade:13305/api/v1/embeddings"
+ )
+ assert normalize_embedding_endpoint_for_display("lemonade", "http://localhost:13305/v1") == (
+ "http://localhost:13305/v1/embeddings"
+ )
+
+
+def test_lemonade_connection_shared_from_llm_resolves_embedding_endpoint() -> None:
+ catalog = _build_catalog(
+ embedding_profile={
+ "id": "embedding-p",
+ "name": "Lemonade embedding",
+ "provider_ref": {"connection_id": "lemonade-connection"},
+ "models": [
+ {
+ "id": "embedding-m",
+ "model": "Qwen3-Embedding-0.6B-GGUF",
+ }
+ ],
+ }
+ )
+ catalog["connections"] = [
+ {
+ "id": "lemonade-connection",
+ "name": "Lemonade Server",
+ "binding": "lemonade",
+ "base_url": "http://lemonade:13305/api/v1",
+ "api_key": "",
+ "source_service": "llm",
+ }
+ ]
+
+ resolved = resolve_embedding_runtime_config(catalog=catalog)
+ assert resolved.provider_name == "lemonade"
+ assert resolved.provider_mode == "local"
+ assert resolved.effective_url == "http://lemonade:13305/api/v1/embeddings"
+ assert get_embedding_config(catalog=catalog).api_key == ""
+
+
+def test_legacy_custom_lemonade_endpoint_stays_keyless() -> None:
+ catalog = _build_catalog(
+ embedding_profile={
+ "id": "embedding-p",
+ "binding": "custom",
+ "base_url": "http://localhost:13305/v1/embeddings",
+ "api_key": "",
+ "models": [
+ {
+ "id": "embedding-m",
+ "model": "Qwen3-Embedding-0.6B-GGUF",
+ }
+ ],
+ }
+ )
+
+ resolved = resolve_embedding_runtime_config(catalog=catalog)
+ assert resolved.provider_name == "lemonade"
+ assert get_embedding_config(catalog=catalog).api_key == ""
+
+
def test_embedding_orcarouter_binding_uses_default_endpoint() -> None:
catalog = _build_catalog(
embedding_profile={