run-llama/llama_index · error · ValueError

Cannot specify both query_str and query_bundle

Error message

Cannot specify both query_str and query_bundle

What it means

Error "Cannot specify both query_str and query_bundle" thrown in run-llama/llama_index.

Source

Thrown at llama-index-core/llama_index/core/postprocessor/types.py:43

    def _get_prompt_modules(self) -> PromptMixinType:
        """Get prompt modules."""
        return {}

    # implement class_name so users don't have to worry about it when extending
    @classmethod
    def class_name(cls) -> str:
        return "BaseNodePostprocessor"

    def postprocess_nodes(
        self,
        nodes: List[NodeWithScore],
        query_bundle: Optional[QueryBundle] = None,
        query_str: Optional[str] = None,
    ) -> List[NodeWithScore]:
        """Postprocess nodes."""
        if query_str is not None and query_bundle is not None:
            raise ValueError("Cannot specify both query_str and query_bundle")
        elif query_str is not None:
            query_bundle = QueryBundle(query_str)
        else:
            pass
        return self._postprocess_nodes(nodes, query_bundle)

    @abstractmethod
    def _postprocess_nodes(
        self,
        nodes: List[NodeWithScore],
        query_bundle: Optional[QueryBundle] = None,
    ) -> List[NodeWithScore]:
        """Postprocess nodes."""

    async def apostprocess_nodes(
        self,
        nodes: List[NodeWithScore],
        query_bundle: Optional[QueryBundle] = None,

View on GitHub (pinned to afd0fef371)

Solutions

1. Pass either query_str or query_bundle, not both.
2. Remove one of the two arguments.

When it happens

Trigger: Thrown at llama-index-core/llama_index/core/postprocessor/types.py:43 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/4b5787a43092efd7. Report an issue: GitHub.