MemPalace/mempalace · error · ValueError

chunk_overlap must be a non-negative int, got {chunk_overlap

Error message

chunk_overlap must be a non-negative int, got {chunk_overlap!r}

What it means

Error "chunk_overlap must be a non-negative int, got {chunk_overlap!r}" thrown in MemPalace/mempalace.

Source

Thrown at mempalace/miner.py:666

    Optional params override module-level defaults when provided.
    """
    if chunk_size is None:
        chunk_size = CHUNK_SIZE
    if chunk_overlap is None:
        chunk_overlap = CHUNK_OVERLAP
    if min_chunk_size is None:
        min_chunk_size = MIN_CHUNK_SIZE

    # Defensive invariant guard. ``MempalaceConfig.chunk_*`` already
    # enforces these and falls back to defaults on bad config.json
    # values, but ``chunk_text`` is a public function — direct callers
    # (tests, library users, future caller paths) might still pass
    # values that would loop forever. Fail fast and loud rather than
    # hang. See review feedback on #1024.
    if not isinstance(chunk_size, int) or chunk_size <= 0:
        raise ValueError(f"chunk_size must be a positive int, got {chunk_size!r}")
    if not isinstance(chunk_overlap, int) or chunk_overlap < 0:
        raise ValueError(f"chunk_overlap must be a non-negative int, got {chunk_overlap!r}")
    if chunk_overlap > chunk_size // 2:
        # The windowing loop pulls ``end`` back to a boundary only when that
        # boundary is past ``start + chunk_size // 2`` (the rfind guards below),
        # so a pulled chunk always spans more than ``chunk_size // 2`` chars.
        # ``start = end - chunk_overlap`` therefore advances only while
        # ``chunk_overlap <= chunk_size // 2``; a larger overlap makes ``start``
        # stall or move backward and the loop spins forever on short-line
        # content (#2056). The largest safe value is ``chunk_size // 2`` (half,
        # rounded down for odd sizes), which still advances and stays allowed.
        raise ValueError(
            f"chunk_overlap ({chunk_overlap}) must be at most chunk_size // 2 "
            f"({chunk_size // 2}); a larger overlap can loop forever on "
            f"short-line content (#2056)"
        )
    if not isinstance(min_chunk_size, int) or min_chunk_size < 0:
        raise ValueError(f"min_chunk_size must be a non-negative int, got {min_chunk_size!r}")

    # Clean up

View on GitHub (pinned to 06cb6987f0)

Solutions

Pass a non-negative integer chunk_overlap

When it happens

Trigger: Thrown at mempalace/miner.py:666 when the library encounters an invalid state.

Common situations: chunk_overlap was negative or not an int.

AI-assisted analysis of MemPalace/mempalace@06cb6987f0 (2026-08-15). Data as JSON: /api/errors/74a44699da493230. Report an issue: GitHub.