HKUDS/DeepTutor · error · ValueError

Knowledge base name cannot contain control characters

Error message

Knowledge base name cannot contain control characters

What it means

Error "Knowledge base name cannot contain control characters" thrown in HKUDS/DeepTutor.

Source

Thrown at deeptutor/knowledge/naming.py:30

def validate_knowledge_base_name(name: str) -> str:
    """Validate and normalize a user-facing knowledge-base name.

    Names may contain Unicode letters, spaces, dots, hyphens, underscores, and
    common punctuation, but must not contain filesystem or URL-reserved
    separators that would break KB directories or API route paths.
    """
    normalized = unicodedata.normalize("NFC", str(name or "")).strip()
    if not normalized:
        raise ValueError("Knowledge base name is required")
    if normalized in {".", ".."}:
        raise ValueError("Knowledge base name cannot be '.' or '..'")
    if len(normalized) > _MAX_KB_NAME_LENGTH:
        raise ValueError(
            f"Knowledge base name is too long; maximum length is {_MAX_KB_NAME_LENGTH}"
        )
    if _CONTROL_CHARS.search(normalized):
        raise ValueError("Knowledge base name cannot contain control characters")

    forbidden = sorted(ch for ch in _FORBIDDEN_CHARS if ch in normalized)
    if forbidden:
        joined = " ".join(forbidden)
        raise ValueError(
            "Knowledge base name contains reserved characters: "
            f"{joined}. Avoid path or URL separators such as /, \\, ?, #, and %."
        )

    return normalized

View on GitHub (pinned to 3e82f13042)

When it happens

Trigger: Thrown at deeptutor/knowledge/naming.py:30 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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