Registry / llm-agents / langchain-weaviate

langchain-weaviate

library0.0.7pypypi✓ verified 84d ago

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.

llm-agents vector-search database

pip install langchain-weaviate

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · LANGCHAIN-WEAVIATE

langchain-weaviate

llm-agentspythonv0.0.7

Install

12.5s avg

Import

5169ms

Disk

192MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.0.7 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 5.754s · 187MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 12.5s · import 4.584s · 188MB

192MB installed

● package 192MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

WeaviateVectorStore

✓ from langchain_weaviate import WeaviateVectorStore

✗ from langchain.vectorstores import Weaviate

Deprecated in langchain-community, use this dedicated package

WeaviateHybridSearchRetriever

✓ from langchain_weaviate import WeaviateHybridSearchRetriever

✗ from langchain.retrievers import WeaviateHybridSearchRetriever

Wrong import path

WeaviateDocumentLoader

✓ from langchain_weaviate.document_loaders import WeaviateDocumentLoader

✗ from langchain.document_loaders import WeaviateDocumentLoader

Cannot find this class in langchain-community

Initialize a Weaviate vector store with embeddings.

import os from langchain_weaviate import WeaviateVectorStore from langchain_community.embeddings import FakeEmbeddings embeddings = FakeEmbeddings(size=512) vectorstore = WeaviateVectorStore.from_documents( documents=[], embedding=embeddings, weaviate_url=os.environ.get("WEAVIATE_URL", "http://localhost:8080"), index_name="MyDocument", client_kwargs={"auth_client_secret": None}, ) print(vectorstore._client.is_ready())

Debug

Known issues

breakingVersion 0.0.6 requires langchain-core>=0.3.0, which is a breaking change from langchain<0.3. Ensure you upgrade langchain-core.

fix

pip install "langchain-core>=0.3.0"

affects: >=0.0.6

gotchaThe `weaviate_url` parameter expects a string like 'http://localhost:8080', not a Weaviate client instance. Using client instance will raise AttributeError.

fix

Pass the URL as a string; client is created internally.

affects: all

gotchaWhen 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.

fix

vectorstore = WeaviateVectorStore(..., client_kwargs={"auth_client_secret": weaviate.auth.AuthApiKey(api_key="your-key")})

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'langchain_weaviate'

Package not installed or installed in wrong environment.

fix

pip install langchain-weaviate

AttributeError: 'str' object has no attribute 'get'

Passing a Weaviate client instance instead of URL string to `weaviate_url`.

fix

Use `weaviate_url="http://localhost:8080"` instead of passing a client.

weaviate.exceptions.WeaviateClosedError: Failed to connect

Weaviate server not running or wrong URL/port.

fix

Start Weaviate via Docker: `docker run -p 8080:8080 semitechnologies/weaviate:1.25.0` and verify URL.

Upgrade

Version history

0.0.7latest on PyPI · released Jun 17, 2026

Audit

Dependencies

langchain-corerequiredrequired for base classes

weaviate-clientrequiredrequired for Weaviate interaction

Agent activity

34 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/langchain-ai/langchain-weaviate ↗

packagehttps://pypi.org/project/langchain-weaviate/ ↗

homepagehttps://python.langchain.com/docs/integrations/vectorstores/weaviate/ ↗