run-llama/llama_index · error · ValueError

Cannot specify both node_parser_ids and chunk_sizes.

Error message

Cannot specify both node_parser_ids and chunk_sizes.

What it means

Error "Cannot specify both node_parser_ids and chunk_sizes." thrown in run-llama/llama_index.

Source

Thrown at llama-index-core/llama_index/core/node_parser/relational/hierarchical.py:141

        callback_manager = callback_manager or CallbackManager([])

        if node_parser_ids is None:
            if chunk_sizes is None:
                chunk_sizes = [2048, 512, 128]

            node_parser_ids = [f"chunk_size_{chunk_size}" for chunk_size in chunk_sizes]
            node_parser_map = {}
            for chunk_size, node_parser_id in zip(chunk_sizes, node_parser_ids):
                node_parser_map[node_parser_id] = SentenceSplitter(
                    chunk_size=chunk_size,
                    callback_manager=callback_manager,
                    chunk_overlap=chunk_overlap,
                    include_metadata=include_metadata,
                    include_prev_next_rel=include_prev_next_rel,
                )
        else:
            if chunk_sizes is not None:
                raise ValueError("Cannot specify both node_parser_ids and chunk_sizes.")
            if node_parser_map is None:
                raise ValueError(
                    "Must specify node_parser_map if using node_parser_ids."
                )

        return cls(
            chunk_sizes=chunk_sizes,
            node_parser_ids=node_parser_ids,
            node_parser_map=node_parser_map,
            include_metadata=include_metadata,
            include_prev_next_rel=include_prev_next_rel,
            callback_manager=callback_manager,
        )

    @classmethod
    def class_name(cls) -> str:
        return "HierarchicalNodeParser"

View on GitHub (pinned to afd0fef371)

Solutions

1. Pass either node_parser_ids or chunk_sizes, not both.
2. Remove one of the two arguments from HierarchicalNodeParser.from_defaults.

When it happens

Trigger: Thrown at llama-index-core/llama_index/core/node_parser/relational/hierarchical.py:141 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/ca64f69b0ac16c83. Report an issue: GitHub.