{"record":{"id":"dc8af2a097dda5f6","repo":"run-llama/llama_index","slug":"llama-index-llms-openai-is-not-installed-please-i","errorCode":null,"errorMessage":"llama-index-llms-openai is not installed. Please install it using `pip install llama-index-multi-modal-llms-openai`","messagePattern":"llama-index-llms-openai is not installed\\. Please install it using `pip install llama-index-multi-modal-llms-openai`","errorType":"exception","errorClass":"ImportError","httpStatus":null,"severity":"error","filePath":"llama-index-core/llama_index/core/evaluation/multi_modal/faithfulness.py","lineNumber":94,"sourceCode":"            The template to use for refining the evaluation.\n\n    \"\"\"\n\n    def __init__(\n        self,\n        multi_modal_llm: Optional[LLM] = None,\n        raise_error: bool = False,\n        eval_template: Union[str, BasePromptTemplate, None] = None,\n        refine_template: Union[str, BasePromptTemplate, None] = None,\n    ) -> None:\n        \"\"\"Init params.\"\"\"\n        if multi_modal_llm is None:\n            try:\n                from llama_index.llms.openai import (\n                    OpenAIResponses,\n                )  # pants: no-infer-dep\n            except ImportError:\n                raise ImportError(\n                    \"llama-index-llms-openai is not installed. \"\n                    \"Please install it using `pip install llama-index-multi-modal-llms-openai`\"\n                )\n\n            self._multi_modal_llm: LLM = OpenAIResponses(\n                model=\"gpt-4.1\", max_output_tokens=1000\n            )\n        else:\n            self._multi_modal_llm = multi_modal_llm\n\n        self._raise_error = raise_error\n\n        self._eval_template: BasePromptTemplate\n        if isinstance(eval_template, str):\n            self._eval_template = PromptTemplate(eval_template)\n        else:\n            self._eval_template = eval_template or DEFAULT_EVAL_TEMPLATE\n","sourceCodeStart":76,"sourceCodeEnd":112,"githubUrl":"https://github.com/run-llama/llama_index/blob/afd0fef371831f9bda13e5af7167cf4e981278ab/llama-index-core/llama_index/core/evaluation/multi_modal/faithfulness.py#L76-L112","documentation":"Raised by MultiModalFaithfulnessEvaluator.__init__ when no multi_modal_llm is supplied and the fallback import of llama_index.llms.openai (package llama-index-llms-openai) fails. Note the message's pip hint names llama-index-multi-modal-llms-openai, but the code actually imports from llama-index-llms-openai — install that package (or pass your own multi-modal LLM).","triggerScenarios":"Instantiating MultiModalFaithfulnessEvaluator() without multi_modal_llm in an environment lacking llama-index-llms-openai (e.g. only llama-index-core is installed).","commonSituations":"Slim installs of llama-index-core without integration extras; using a non-OpenAI multi-modal backend but forgetting to pass it explicitly; env corruption or wrong virtualenv; confusion caused by the misleading pip hint in the error text.","solutions":["pip install llama-index-llms-openai (despite the message mentioning llama-index-multi-modal-llms-openai, the import resolves to the former; the extra llama-index-llms-openai[multi-modal] variant covers vision deps).","Or pass your own LLM: MultiModalFaithfulnessEvaluator(multi_modal_llm=your_mm_llm) to avoid the OpenAI fallback entirely.","Verify with python -c \"from llama_index.llms.openai import OpenAIResponses\" that the import resolves."],"exampleFix":"# before (ImportError)\nevaluator = MultiModalFaithfulnessEvaluator()\n\n# after (option 1): pip install llama-index-llms-openai\nevaluator = MultiModalFaithfulnessEvaluator()\n\n# after (option 2): supply the LLM explicitly\nevaluator = MultiModalFaithfulnessEvaluator(multi_modal_llm=my_openai_llm)","handlingStrategy":"try-catch","validationCode":"try:\n    from llama_index.llms.openai import OpenAIResponses  # noqa\n    CAN_DEFAULT = True\nexcept ImportError:\n    CAN_DEFAULT = False\n\nevaluator = (\n    MultiModalFaithfulnessEvaluator()\n    if CAN_DEFAULT\n    else MultiModalFaithfulnessEvaluator(multi_modal_llm=my_llm)\n)","typeGuard":null,"tryCatchPattern":"try:\n    evaluator = MultiModalFaithfulnessEvaluator()\nexcept ImportError:\n    raise SystemExit(\"install llama-index-llms-openai or pass multi_modal_llm=\") from None","preventionTips":["Add llama-index-llms-openai (or the multi-modal extra) to your dependency list when using this evaluator.","Pass multi_modal_llm explicitly in production so behavior does not depend on an implicit fallback import."],"tags":["optional-dependency","multi-modal","installation","openai"],"backgroundTag":null,"analyzedSha":"afd0fef371831f9bda13e5af7167cf4e981278ab","analyzedAt":"2026-08-15T05:42:58.429Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}