{"id":23952,"library":"langchain-weaviate","title":"langchain-weaviate","description":"An integration package connecting Weaviate vector database with LangChain, providing vector store, retriever, and document loader. Current version 0.0.6 supports Python >=3.10,<4.0. Release cadence is monthly.","status":"active","version":"0.0.6","language":"python","source_language":"en","source_url":"https://github.com/langchain-ai/langchain-weaviate","tags":["langchain","weaviate","vector-database","integration"],"install":[{"cmd":"pip install langchain-weaviate","lang":"bash","label":"latest"}],"dependencies":[{"reason":"required for base classes","package":"langchain-core","optional":false},{"reason":"required for Weaviate interaction","package":"weaviate-client","optional":false}],"imports":[{"note":"Deprecated in langchain-community, use this dedicated package","wrong":"from langchain.vectorstores import Weaviate","symbol":"WeaviateVectorStore","correct":"from langchain_weaviate import WeaviateVectorStore"},{"note":"Wrong import path","wrong":"from langchain.retrievers import WeaviateHybridSearchRetriever","symbol":"WeaviateHybridSearchRetriever","correct":"from langchain_weaviate import WeaviateHybridSearchRetriever"},{"note":"Cannot find this class in langchain-community","wrong":"from langchain.document_loaders import WeaviateDocumentLoader","symbol":"WeaviateDocumentLoader","correct":"from langchain_weaviate.document_loaders import WeaviateDocumentLoader"}],"quickstart":{"code":"import os\nfrom langchain_weaviate import WeaviateVectorStore\nfrom langchain_community.embeddings import FakeEmbeddings\n\nembeddings = FakeEmbeddings(size=512)\nvectorstore = WeaviateVectorStore.from_documents(\n    documents=[],\n    embedding=embeddings,\n    weaviate_url=os.environ.get(\"WEAVIATE_URL\", \"http://localhost:8080\"),\n    index_name=\"MyDocument\",\n    client_kwargs={\"auth_client_secret\": None},\n)\nprint(vectorstore._client.is_ready())","lang":"python","description":"Initialize a Weaviate vector store with embeddings."},"warnings":[{"fix":"pip install \"langchain-core>=0.3.0\"","message":"Version 0.0.6 requires langchain-core>=0.3.0, which is a breaking change from langchain<0.3. Ensure you upgrade langchain-core.","severity":"breaking","affected_versions":">=0.0.6"},{"fix":"Pass the URL as a string; client is created internally.","message":"The `weaviate_url` parameter expects a string like 'http://localhost:8080', not a Weaviate client instance. Using client instance will raise AttributeError.","severity":"gotcha","affected_versions":"all"},{"fix":"vectorstore = WeaviateVectorStore(..., client_kwargs={\"auth_client_secret\": weaviate.auth.AuthApiKey(api_key=\"your-key\")})","message":"When connecting to Weaviate Cloud (WCD), you must provide `auth_client_secret` in `client_kwargs`, not as a top-level parameter. Common mistake: passing `auth_client_secret` as a separate argument.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"pip install langchain-weaviate","cause":"Package not installed or installed in wrong environment.","error":"ModuleNotFoundError: No module named 'langchain_weaviate'"},{"fix":"Use `weaviate_url=\"http://localhost:8080\"` instead of passing a client.","cause":"Passing a Weaviate client instance instead of URL string to `weaviate_url`.","error":"AttributeError: 'str' object has no attribute 'get'"},{"fix":"Start Weaviate via Docker: `docker run -p 8080:8080 semitechnologies/weaviate:1.25.0` and verify URL.","cause":"Weaviate server not running or wrong URL/port.","error":"weaviate.exceptions.WeaviateClosedError: Failed to connect"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}