HKUDS/DeepTutor · error · HTTPException

LightRAG is not installed. Run `pip install 'deeptutor[rag-l

Error message

LightRAG is not installed. Run `pip install 'deeptutor[rag-lightrag]'` on the server before creating a LightRAG knowledge base.

What it means

Raised by _assert_provider_ready when provider is lightrag and is_lightrag_available() is False — the optional LightRAG dependency group is not installed on the server. Identical pattern to the GraphRAG missing-package error (150) but for the rag-lightrag extra.

Source

Thrown at deeptutor/api/routers/knowledge.py:717

            check
            for check in report.get("checks", [])
            if not check.get("optional") and not check.get("ok")
        ]
        if failed_checks:
            failure_details = "; ".join(
                str(check.get("detail") or check.get("label") or "Requirement not met")
                for check in failed_checks
            )
            raise HTTPException(
                status_code=409,
                detail=f"GraphRAG preflight failed: {failure_details}",
            )

    if provider == LIGHTRAG_PROVIDER:
        from deeptutor.services.rag.pipelines.lightrag.config import is_lightrag_available

        if not is_lightrag_available():
            raise HTTPException(
                status_code=400,
                detail=(
                    "LightRAG is not installed. Run "
                    "`pip install 'deeptutor[rag-lightrag]'` on the server before "
                    "creating a LightRAG knowledge base."
                ),
            )


def _enforce_provider_formats(provider: str, files: list[UploadFile]) -> None:
    """Reject files PageIndex's document endpoint does not accept, up front."""
    if provider not in {PAGEINDEX_PROVIDER, PAGEINDEX_OSS_PROVIDER}:
        return
    from deeptutor.services.rag.pipelines.pageindex.pipeline import (
        OSS_SUPPORTED_EXTENSIONS,
        SUPPORTED_EXTENSIONS,
    )

View on GitHub (pinned to 3e82f13042)

Solutions

1. Install the extra on the server: pip install 'deeptutor[rag-lightrag]'
2. Verify availability from the server venv (import is_lightrag_available and assert True)
3. Restart the server and retry

Example fix

# before
pip install deeptutor
# after
pip install 'deeptutor[rag-lightrag]'

from deeptutor.services.rag.pipelines.lightrag.config import is_lightrag_available
assert is_lightrag_available(), "pip install 'deeptutor[rag-lightrag]'"

When it happens

Trigger: Creating/uploading/reindexing a KB with provider=lightrag on an environment installed without `deeptutor[rag-lightrag]`.

Common situations: Default pip install without extras; Docker image built from a requirements file that omits the lightrag group; upgrading deeptutor dropped the previously-installed extra.

Related errors

• GraphRAG is not installed. Run `pip install 'deeptutor[graph
• PageIndex API key is not configured. Add it under Knowledge
• server_url is required.
• Both name and server_url are required.
• result.error or "Could not connect to the LightRAG server."

AI-assisted analysis of HKUDS/DeepTutor@3e82f13042 (2026-08-27). Data as JSON: /api/errors/f91efd4d732629ed. Report an issue: GitHub.