{"id":23984,"library":"llama-index-vector-stores-weaviate","title":"LlamaIndex Vector Stores Weaviate","description":"LlamaIndex integration for Weaviate vector database. Supports hybrid search, vector indexing, filtering, and metadata storage. Version 1.6.0 requires Python >=3.10, <4.0. Active development.","status":"active","version":"1.6.0","language":"python","source_language":"en","source_url":"https://github.com/run-llama/llama_index/tree/main/llama-index-integrations/vector_stores/llama-index-vector-stores-weaviate","tags":["llama-index","vector-store","weaviate","rag","embeddings"],"install":[{"cmd":"pip install llama-index-vector-stores-weaviate","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core dependency for LlamaIndex abstractions","package":"llama-index-core","optional":false},{"reason":"Official Weaviate Python client","package":"weaviate-client","optional":false}],"imports":[{"note":"Standard import path after version 0.9+; earlier used 'llama_index.vector_stores.weaviate' (no 'vector_stores' package) but was deprecated in 0.9.","wrong":null,"symbol":"WeaviateVectorStore","correct":"from llama_index.vector_stores.weaviate import WeaviateVectorStore"},{"note":"Used for defining additional metadata properties.","wrong":null,"symbol":"WeaviateProperty","correct":"from llama_index.vector_stores.weaviate import WeaviateProperty"}],"quickstart":{"code":"import weaviate\nfrom llama_index.core import VectorStoreIndex, StorageContext\nfrom llama_index.vector_stores.weaviate import WeaviateVectorStore\n# Connect to Weaviate (e.g., local Docker)\nclient = weaviate.Client(\"http://localhost:8080\")\n# Create vector store\nvector_store = WeaviateVectorStore(weaviate_client=client, index_name=\"LlamaIndex\")\n# Create index from documents\ndocuments = [Document(text=\"llama-index is awesome\")]\nstorage_context = StorageContext.from_defaults(vector_store=vector_store)\nindex = VectorStoreIndex.from_documents(documents, storage_context=storage_context)\n# Query\nquery_engine = index.as_query_engine()\nresponse = query_engine.query(\"What is llama-index?\")\nprint(response)","lang":"python","description":"Basic usage: connect to Weaviate, store documents, and query."},"warnings":[{"fix":"Update import to 'from llama_index.vector_stores.weaviate import WeaviateVectorStore'.","message":"In version 0.9+, the import path changed from 'llama_index.vector_stores.weaviate' to 'llama_index.vector_stores.weaviate' (the package was restructured). Old code using 'from llama_index.vector_stores.weaviate import WeaviateVectorStore' will break unless you downgrade.","severity":"breaking","affected_versions":">=0.9.0"},{"fix":"Use 'from llama_index.core import VectorStoreIndex'.","message":"The 'from llama_index import VectorStoreIndex' pattern is deprecated in favor of 'from llama_index.core import VectorStoreIndex' since version 0.10.","severity":"deprecated","affected_versions":">=0.10.0"},{"fix":"Use keyword argument 'weaviate_client=client'.","message":"WeaviateVectorStore expects a 'weaviate_client' parameter (not 'client'). Passing 'client' will raise a TypeError.","severity":"gotcha","affected_versions":"All"},{"fix":"Use proper CamelCase (e.g., 'LlamaIndex' not 'llama_index').","message":"The 'index_name' parameter must match an existing class in Weaviate, or Weaviate will create one automatically. Ensure it is a valid CamelCase name.","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":"Install with 'pip install llama-index-vector-stores-weaviate' and use correct import: 'from llama_index.vector_stores.weaviate import WeaviateVectorStore'.","cause":"Package not installed or wrong import path for older versions.","error":"ModuleNotFoundError: No module named 'llama_index.vector_stores.weaviate'"},{"fix":"Use 'WeaviateVectorStore(weaviate_client=client, ...)'.","cause":"Parameter name is 'weaviate_client', not 'client'.","error":"TypeError: WeaviateVectorStore.__init__() got an unexpected keyword argument 'client'"},{"fix":"Ensure Weaviate is running (e.g., 'docker run -p 8080:8080 semitechnologies/weaviate:latest') and use correct URL like 'http://localhost:8080'.","cause":"Weaviate server not running or incorrect URL.","error":"weaviate.exceptions.WeaviateClosedError: Weaviate is closed or not responding"},{"fix":"Ensure 'auto_schema.enabled' is true in Weaviate configuration, or manually create the class with 'client.schema.create_class(...)'.","cause":"Class name does not exist; Weaviate supports automatic schema creation but may require explicit creation if settings disallow auto-schema.","error":"ValueError: Could not find class 'LlamaIndex' in Weaviate schema"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}