{"record":{"id":"b132bb3fdc25532b","repo":"run-llama/llama_index","slug":"argillacallbackhandler-is-not-installed-please-in","errorCode":null,"errorMessage":"ArgillaCallbackHandler is not installed. Please install it using `pip install llama-index-callbacks-argilla`","messagePattern":"ArgillaCallbackHandler is not installed\\. Please install it using `pip install llama-index-callbacks-argilla`","errorType":"exception","errorClass":"ImportError","httpStatus":null,"severity":"error","filePath":"llama-index-core/llama_index/core/callbacks/global_handlers.py","lineNumber":97,"sourceCode":"        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\":\n        try:\n            from llama_index.callbacks.langfuse import (\n                langfuse_callback_handler,\n            )  # pants: no-infer-dep\n        except ImportError:\n            raise ImportError(\n                \"LangfuseCallbackHandler is not installed. \"\n                \"Please install it using `pip install llama-index-callbacks-langfuse`\"\n            )\n        handler = langfuse_callback_handler(**eval_params)\n    elif eval_mode == \"agentops\":\n        try:\n            from llama_index.callbacks.agentops import (","sourceCodeStart":79,"sourceCodeEnd":115,"githubUrl":"https://github.com/run-llama/llama_index/blob/afd0fef371831f9bda13e5af7167cf4e981278ab/llama-index-core/llama_index/core/callbacks/global_handlers.py#L79-L115","documentation":"Raised by create_global_handler() when eval_mode is 'argilla' but llama-index-callbacks-argilla is absent. Argilla feedback/tracing is an optional integration; the lazy import failure is caught and re-raised as an ImportError with the install command.","triggerScenarios":"create_global_handler('argilla', ...) or set_global_handler('argilla') with the package missing; `from llama_index.callbacks.argilla import argilla_callback_handler` fails.","commonSituations":"Using Argilla annotation workflows with LlamaIndex without the bridge package; fresh environments cloned from repos whose requirements file omits optional extras.","solutions":["pip install llama-index-callbacks-argilla","Verify: python -c \"from llama_index.callbacks.argilla import argilla_callback_handler\"","Configure Argilla dataset/credentials before enabling the handler","Remove the argilla eval mode if tracing to Argilla was not intended"],"exampleFix":"# before\nset_global_handler('argilla')  # ImportError\n\n# after\n# pip install llama-index-callbacks-argilla\nset_global_handler('argilla')","handlingStrategy":"validation","validationCode":"import importlib.util\nif importlib.util.find_spec('llama_index.callbacks.argilla') is None:\n    raise SystemExit('pip install llama-index-callbacks-argilla')","typeGuard":null,"tryCatchPattern":"try:\n    handler = create_global_handler('argilla')\nexcept ImportError as e:\n    handler = None","preventionTips":["Verify Argilla server reachability and the integration wheel together in a health check","Keep annotation pipelines' dependency sets explicit"],"tags":["llama-index","callbacks","import-error","optional-dependency","argilla"],"backgroundTag":null,"analyzedSha":"afd0fef371831f9bda13e5af7167cf4e981278ab","analyzedAt":"2026-08-15T05:42:58.429Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}