{"record":{"id":"4e090a67c39a334b","repo":"run-llama/llama_index","slug":"deepevalcallbackhandler-is-not-installed-please-i","errorCode":null,"errorMessage":"DeepEvalCallbackHandler is not installed. Please install it using `pip install llama-index-callbacks-deepeval`","messagePattern":"DeepEvalCallbackHandler is not installed\\. Please install it using `pip install llama-index-callbacks-deepeval`","errorType":"exception","errorClass":"ImportError","httpStatus":null,"severity":"error","filePath":"llama-index-core/llama_index/core/callbacks/global_handlers.py","lineNumber":84,"sourceCode":"        handler = honeyhive_callback_handler(**eval_params)\n    elif eval_mode == \"promptlayer\":\n        try:\n            from llama_index.callbacks.promptlayer import (\n                PromptLayerHandler,\n            )  # pants: no-infer-dep\n        except ImportError:\n            raise ImportError(\n                \"PromptLayerHandler is not installed. \"\n                \"Please install it using `pip install llama-index-callbacks-promptlayer`\"\n            )\n        handler = PromptLayerHandler(**eval_params)\n    elif eval_mode == \"deepeval\":\n        try:\n            from llama_index.callbacks.deepeval import (\n                deepeval_callback_handler,\n            )  # pants: no-infer-dep\n        except ImportError:\n            raise ImportError(\n                \"DeepEvalCallbackHandler is not installed. \"\n                \"Please install it using `pip install llama-index-callbacks-deepeval`\"\n            )\n        handler = deepeval_callback_handler(**eval_params)\n    elif eval_mode == \"simple\":\n        handler = SimpleLLMHandler(**eval_params)\n    elif eval_mode == \"argilla\":\n        try:\n            from llama_index.callbacks.argilla import (\n                argilla_callback_handler,\n            )  # pants: no-infer-dep\n        except ImportError:\n            raise ImportError(\n                \"ArgillaCallbackHandler is not installed. \"\n                \"Please install it using `pip install llama-index-callbacks-argilla`\"\n            )\n        handler = argilla_callback_handler(**eval_params)\n    elif eval_mode == \"langfuse\":","sourceCodeStart":66,"sourceCodeEnd":102,"githubUrl":"https://github.com/run-llama/llama_index/blob/afd0fef371831f9bda13e5af7167cf4e981278ab/llama-index-core/llama_index/core/callbacks/global_handlers.py#L66-L102","documentation":"Raised by create_global_handler() when eval_mode is 'deepeval' but llama-index-callbacks-deepeval is not installed. The DeepEval callback (LLM evaluation metrics) is optional and imported lazily; a missing wheel produces this ImportError naming the package.","triggerScenarios":"create_global_handler('deepeval', ...) / set_global_handler('deepeval') in an env without the wheel; `from llama_index.callbacks.deepeval import deepeval_callback_handler` raises ImportError.","commonSituations":"Running evaluation-enabled scripts on machines where only llama-index-core was pinned; CI pipelines that cache an older dependency set; installing deepeval itself but not the LlamaIndex bridge package.","solutions":["pip install llama-index-callbacks-deepeval","Verify: python -c \"from llama_index.callbacks.deepeval import deepeval_callback_handler\"","Pin the integration version in requirements.txt","Unset the deepeval eval mode for runs that do not evaluate"],"exampleFix":"# before\nset_global_handler('deepeval')  # ImportError\n\n# after\n# pip install llama-index-callbacks-deepeval\nset_global_handler('deepeval')","handlingStrategy":"validation","validationCode":"import importlib.util\nif importlib.util.find_spec('llama_index.callbacks.deepeval') is None:\n    raise SystemExit('pip install llama-index-callbacks-deepeval')","typeGuard":null,"tryCatchPattern":"try:\n    handler = create_global_handler('deepeval')\nexcept ImportError as e:\n    raise  # evaluation runs should fail loudly if deepeval is missing","preventionTips":["Separate eval dependencies into an extras group (e.g. -e '.[eval]') so eval jobs fail at install, not runtime","Smoke-test eval entry points in CI"],"tags":["llama-index","callbacks","import-error","optional-dependency","deepeval"],"backgroundTag":null,"analyzedSha":"afd0fef371831f9bda13e5af7167cf4e981278ab","analyzedAt":"2026-08-15T05:42:58.429Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}