run-llama/llama_index · error · NotImplementedError

Batching not supported by this key-value store.

Error message

Batching not supported by this key-value store.

What it means

Error "Batching not supported by this key-value store." thrown in run-llama/llama_index.

Source

Thrown at llama-index-core/llama_index/core/storage/kvstore/types.py:32

    @abstractmethod
    def put(self, key: str, val: dict, collection: str = DEFAULT_COLLECTION) -> None:
        pass

    @abstractmethod
    async def aput(
        self, key: str, val: dict, collection: str = DEFAULT_COLLECTION
    ) -> None:
        pass

    def put_all(
        self,
        kv_pairs: List[Tuple[str, dict]],
        collection: str = DEFAULT_COLLECTION,
        batch_size: int = DEFAULT_BATCH_SIZE,
    ) -> None:
        # by default, support a batch size of 1
        if batch_size != 1:
            raise NotImplementedError("Batching not supported by this key-value store.")
        else:
            for key, val in kv_pairs:
                self.put(key, val, collection=collection)

    async def aput_all(
        self,
        kv_pairs: List[Tuple[str, dict]],
        collection: str = DEFAULT_COLLECTION,
        batch_size: int = DEFAULT_BATCH_SIZE,
    ) -> None:
        # by default, support a batch size of 1
        if batch_size != 1:
            raise NotImplementedError("Batching not supported by this key-value store.")
        else:
            for key, val in kv_pairs:
                await self.aput(key, val, collection=collection)

    @abstractmethod

View on GitHub (pinned to afd0fef371)

Solutions

1. Use a kvstore implementation that supports batching, or issue individual put calls.
2. Check the store's capabilities and fall back to per-key operations.

When it happens

Trigger: Thrown at llama-index-core/llama_index/core/storage/kvstore/types.py:32 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of run-llama/llama_index@afd0fef371 (2026-08-15). Data as JSON: /api/errors/ed18a92d2ebfdc5d. Report an issue: GitHub.