run-llama/llama_index · error · ImportError

pandas is required for this function. Please install it with

Error message

pandas is required for this function. Please install it with `pip install pandas`.

What it means

Error "pandas is required for this function. Please install it with `pip install pandas`." thrown in run-llama/llama_index.

Source

Thrown at llama-index-core/llama_index/core/playground/base.py:184

                result.append(
                    {
                        "Index": index_name,
                        "Retriever Mode": retriever_mode,
                        "Output": str(output),
                        "Duration": duration,
                        "Prompt Tokens": token_counter.prompt_llm_token_count,
                        "Completion Tokens": token_counter.completion_llm_token_count,
                        "Embed Tokens": token_counter.total_embedding_token_count,
                    }
                )
        print(f"\nRan {len(result)} combinations in total.")

        if to_pandas:
            try:
                import pandas as pd
            except ImportError:
                raise ImportError(
                    "pandas is required for this function. Please install it with `pip install pandas`."
                )

            return pd.DataFrame(result)
        else:
            return result

View on GitHub (pinned to afd0fef371)

Solutions

1. Install pandas: `pip install pandas`.

When it happens

Trigger: Thrown at llama-index-core/llama_index/core/playground/base.py:184 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/d1eb791488c667f8. Report an issue: GitHub.