{"record":{"id":"d3a4b0998ab068f3","repo":"crewAIInc/crewAI","slug":"contextual-client-package-is-required-install-it","errorCode":null,"errorMessage":"contextual-client package is required. Install it with: pip install contextual-client","messagePattern":"contextual-client package is required\\. Install it with: pip install contextual-client","errorType":"exception","errorClass":"ImportError","httpStatus":null,"severity":"error","filePath":"lib/crewai-tools/src/crewai_tools/tools/contextualai_create_agent_tool/contextual_create_agent_tool.py","lineNumber":40,"sourceCode":"    description: str = (\n        \"Create a new Contextual AI RAG agent with documents and datastore\"\n    )\n    args_schema: type[BaseModel] = ContextualAICreateAgentSchema\n\n    api_key: str\n    contextual_client: Any = None\n    package_dependencies: list[str] = Field(\n        default_factory=lambda: [\"contextual-client\"]\n    )\n\n    def __init__(self, **kwargs: Any) -> None:\n        super().__init__(**kwargs)\n        try:\n            from contextual import ContextualAI\n\n            self.contextual_client = ContextualAI(api_key=self.api_key)\n        except ImportError as e:\n            raise ImportError(\n                \"contextual-client package is required. Install it with: pip install contextual-client\"\n            ) from e\n\n    def _run(\n        self,\n        agent_name: str,\n        agent_description: str,\n        datastore_name: str,\n        document_paths: list[str],\n    ) -> str:\n        \"\"\"Create a complete RAG pipeline with documents.\"\"\"\n        resolved_paths = [validate_file_path(doc_path) for doc_path in document_paths]\n        try:\n            import os\n\n            datastore = self.contextual_client.datastores.create(name=datastore_name)\n            datastore_id = datastore.id\n","sourceCodeStart":22,"sourceCodeEnd":58,"githubUrl":"https://github.com/crewAIInc/crewAI/blob/754d7323beb2fd042e33444a115ea2d5a47193f0/lib/crewai-tools/src/crewai_tools/tools/contextualai_create_agent_tool/contextual_create_agent_tool.py#L22-L58","documentation":"Error \"contextual-client package is required. Install it with: pip install contextual-client\" thrown in crewAIInc/crewAI.","triggerScenarios":"Thrown at lib/crewai-tools/src/crewai_tools/tools/contextualai_create_agent_tool/contextual_create_agent_tool.py:40 when the library encounters an invalid state.","commonSituations":"Occurs when the contextual-client package is not installed. Install it with: pip install contextual-client.","solutions":["Install the package with `pip install contextual-client`."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"754d7323beb2fd042e33444a115ea2d5a47193f0","analyzedAt":"2026-08-15T04:06:56.746Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}