{"record":{"id":"a388e21b610b5f5d","repo":"HKUDS/DeepTutor","slug":"no-active-embedding-model-configure-one-under-set","errorCode":null,"errorMessage":"No active embedding model. Configure one under Settings → Catalog before creating a GraphRAG knowledge base.","messagePattern":"No active embedding model\\. Configure one under Settings → Catalog before creating a GraphRAG knowledge base\\.","errorType":"exception","errorClass":"GraphRagNotConfiguredError","httpStatus":null,"severity":"error","filePath":"deeptutor/services/rag/pipelines/graphrag/config.py","lineNumber":264,"sourceCode":"    if llm_cfg is None:\n        from deeptutor.services.config import resolve_llm_runtime_config\n\n        llm_cfg = resolve_llm_runtime_config()\n    if embedding_cfg is None:\n        from deeptutor.services.embedding import get_embedding_config\n\n        embedding_cfg = get_embedding_config()\n\n    chat_model = getattr(llm_cfg, \"model\", None)\n    embed_model = getattr(embedding_cfg, \"model\", None)\n    embed_dim = int(getattr(embedding_cfg, \"dim\", 0) or 0)\n    if not chat_model:\n        raise GraphRagNotConfiguredError(\n            \"No active chat model. Configure one under Settings → Catalog before \"\n            \"creating a GraphRAG knowledge base.\"\n        )\n    if not embed_model:\n        raise GraphRagNotConfiguredError(\n            \"No active embedding model. Configure one under Settings → Catalog \"\n            \"before creating a GraphRAG knowledge base.\"\n        )\n    if not embed_dim:\n        raise GraphRagNotConfiguredError(\n            \"No active embedding model with a known dimension. Configure one under \"\n            \"Settings → Catalog before creating a GraphRAG knowledge base.\"\n        )\n\n    embedding_binding = str(getattr(embedding_cfg, \"binding\", \"\") or \"\")\n    llm_base = getattr(llm_cfg, \"effective_url\", None) or getattr(llm_cfg, \"base_url\", None)\n    embed_endpoint = getattr(embedding_cfg, \"effective_url\", None) or getattr(\n        embedding_cfg, \"base_url\", None\n    )\n    ensure_graphrag_embedding_transport(embedding_binding, embed_endpoint)\n    embed_base = graphrag_embedding_api_base(embedding_binding, embed_endpoint)\n\n    return {","sourceCodeStart":246,"sourceCodeEnd":282,"githubUrl":"https://github.com/HKUDS/DeepTutor/blob/3e82f130422a813cdd73c10b21a44e9325f5821a/deeptutor/services/rag/pipelines/graphrag/config.py#L246-L282","documentation":"GraphRagNotConfiguredError from build_settings: no active embedding model is configured (embedding_cfg.model is empty). GraphRAG needs an embedding model to vectorize extracted entities/relationships.","triggerScenarios":"Calling write_settings or add_documents for a GraphRAG KB with no embedding profile activated under Settings → Catalog.","commonSituations":"Embedding profile never set on fresh installs; embedding profile removed or renamed; per-pipeline embedding selection not persisted.","solutions":["Activate an embedding model under Settings → Catalog.","Confirm get_embedding_config().model returns a value in the process running GraphRAG.","Prefer an OpenAI-compatible embedding profile (see errors 985/986)."],"exampleFix":"# before: get_embedding_config().model is None\n# after\nawait settings.set_active_embedding_model(\"text-embedding-3-small\")","handlingStrategy":"validation","validationCode":"if not getattr(get_embedding_config(), \"model\", None):\n    raise ConfigError(\"activate an embedding model first\")","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Treat both chat and embedding activation as prerequisites in setup wizards."],"tags":["graphrag","configuration","missing-model","embeddings"],"backgroundTag":"missing-model-configuration","analyzedSha":"3e82f130422a813cdd73c10b21a44e9325f5821a","analyzedAt":"2026-08-27T06:57:25.364Z","schemaVersion":2},"datasetVersion":"2026-08-27T08:17:20.692Z"}