{"record":{"id":"aa6b4a1933ff9f50","repo":"run-llama/llama_index","slug":"honeyhivecallbackhandler-is-not-installed-please","errorCode":null,"errorMessage":"HoneyHiveCallbackHandler is not installed. Please install it using `pip install llama-index-callbacks-honeyhive`","messagePattern":"HoneyHiveCallbackHandler is not installed\\. Please install it using `pip install llama-index-callbacks-honeyhive`","errorType":"exception","errorClass":"ImportError","httpStatus":null,"severity":"error","filePath":"llama-index-core/llama_index/core/callbacks/global_handlers.py","lineNumber":62,"sourceCode":"    elif eval_mode == \"arize_phoenix\":\n        try:\n            from llama_index.callbacks.arize_phoenix import (\n                arize_phoenix_callback_handler,\n            )  # pants: no-infer-dep\n        except ImportError:\n            raise ImportError(\n                \"ArizePhoenixCallbackHandler is not installed. \"\n                \"Please install it using `pip install llama-index-callbacks-arize-phoenix`\"\n            )\n\n        handler = arize_phoenix_callback_handler(**eval_params)\n    elif eval_mode == \"honeyhive\":\n        try:\n            from llama_index.callbacks.honeyhive import (\n                honeyhive_callback_handler,\n            )  # pants: no-infer-dep\n        except ImportError:\n            raise ImportError(\n                \"HoneyHiveCallbackHandler is not installed. \"\n                \"Please install it using `pip install llama-index-callbacks-honeyhive`\"\n            )\n        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 (","sourceCodeStart":44,"sourceCodeEnd":80,"githubUrl":"https://github.com/run-llama/llama_index/blob/afd0fef371831f9bda13e5af7167cf4e981278ab/llama-index-core/llama_index/core/callbacks/global_handlers.py#L44-L80","documentation":"Raised by create_global_handler() when eval_mode is 'honeyhive' but llama-index-callbacks-honeyhive is not installed. HoneyHive is one of several optional observability integrations; the handler is imported lazily and a missing wheel is reported with the precise pip command.","triggerScenarios":"create_global_handler('honeyhive', ...) / set_global_handler('honeyhive') with the integration wheel missing; the `from llama_index.callbacks.honeyhive import honeyhive_callback_handler` import raises ImportError.","commonSituations":"Copy-pasting HoneyHive tutorial code into a project that only depends on llama-index-core; forgetting the extra when moving from a notebook (where it was installed) to a clean deployment image.","solutions":["pip install llama-index-callbacks-honeyhive","Verify: python -c \"from llama_index.callbacks.honeyhive import honeyhive_callback_handler\"","Ensure HoneyHive API key/environment is configured if you proceed with tracing","Drop the honeyhive eval mode if it was set accidentally"],"exampleFix":"# before\nset_global_handler('honeyhive', project='x')  # ImportError\n\n# after\n# pip install llama-index-callbacks-honeyhive\nset_global_handler('honeyhive', project='x')","handlingStrategy":"validation","validationCode":"import importlib.util\nif importlib.util.find_spec('llama_index.callbacks.honeyhive') is None:\n    raise SystemExit('pip install llama-index-callbacks-honeyhive')","typeGuard":null,"tryCatchPattern":"try:\n    handler = create_global_handler('honeyhive')\nexcept ImportError as e:\n    handler = None","preventionTips":["Pin integration package versions to avoid resolution drift","Keep a single 'tracing extras' requirements file listing all callback packages in use"],"tags":["llama-index","callbacks","import-error","optional-dependency","honeyhive"],"backgroundTag":null,"analyzedSha":"afd0fef371831f9bda13e5af7167cf4e981278ab","analyzedAt":"2026-08-15T05:42:58.429Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}