NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #348 most downloaded on PyPI
A python native Weaviate client
Last release 23 days ago
07 Sep 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
7 years old
296 releases · first in 2019
Add nvidia-reranker factory function by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/1558
nvidia-reranker factory function by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/1558collections.use as alias for collections.get by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1571None are supplied by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1570Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.11.0...v4.11.1
Fixes exporting of named vector collections
Support for upcoming weaviate agents. User pip install weaviate-client[agents] to try it out
Raise error if a header with value None` has been added
collections.use is the preferred method to create an in-memory collection object
collections.get will be deprecated in the future and should not be used in new code
One column per quarter.
Add support for ColBERT vectors by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1521
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.10.4...v4.11.0
RBAC is ready for production
Multi-dimensional/COLBert vectors experimental, breaking changes are expected
Aggregations are using GRPC now
Improved exception handling for errors returned by Weaviate
multi2vec-nvidia
text2vec-nvidia
generative-nvidia
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add dimensions param to text2vec_azure_openai by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1508
text2vec_azure_openai by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1508Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.10.3...v4.10.4
Fix missing dimensions parameter in text2vec-azure-openai
Fix backup/restore for the embedded server by @parkerduckworth in https://github.com/weaviate/weaviate-python-client/pull/1485
BlockingIOError exceptions are ignored in event loop by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1503threading.Lock with asyncio.Lock when batching to avoid deadlocks by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1270Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.10.2...v4.10.3
Add experimental debug namespace
Add support for dynamic backup location
Fix potential deadlock in batching
Fix backup and restore for embedded mode
Add extra method for text2vec_google_aistudio
Reduce test matrix by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1478
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.10.1...v4.10.2
Fixes issue with query parameters in cluster.nodes method due to dependence on bugged behaviour of httpx that was fixed in 0.28.0
Enable new httpx versions by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1474
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.10.0...v4.10.1
Fixes compatibility with httpx to 0.28.X which requires updating the minimum required version to 0.26.0
Remove outdated docs
Remove v3 by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1452
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.9.6...v4.10.0
RBAC (experimental, breaking changes are expected)
Add VoyageAI's new multimodal embedding model
Update your code to v4: https://weaviate.io/developers/weaviate/client-libraries/python/v3_v4_migration
Use the v3-client directly: weaviate-client>=3.26.7;<4.0.0
Upgrade protobuf to v5
Add support for python 3.13
Weaviate v1.23 and v1.24 are NOT supported anymore
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add support for kagame_ja by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1449
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.9.5...v4.9.6
This release is the last release that supports weaviate v1.23 and v1.24
Add support for the new Kagame_JA tokenizer
Add specific exception for tenant get by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1435
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.9.4...v4.9.5
Add support for the new text2vec-weaviate module
Wrap tenant.get AioRpcError in a specific exception
fix type boolean restriction on include vector for _QueryReference by @paul7Junior in https://github.com/weaviate/weaviate-python-client/pull/1399
multi2vec-jinaai; docstring changes by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/1422Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.9.3...v4.9.4
Add support for multi2vec-jinaai
Add support for multi2vec-cohere
Add support for time-based deletion strategy
Fix type restriction on include_vector in QueryReference
Add missing options to sync interface by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1386
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.9.2...v4.9.3
Fixes interface for updating generative and reranker collection settings
Ensure each per-process event loop has its exception handler patched properly by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.9.1...v4.9.2
Suppress gRPC library warnings for each event loop used in each process
Fix warning message for multi vector search by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1353
_EventLoopSingleton by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1373Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.9.0...v4.9.1
Fix event loop being used from multiple processes
Add updating generative and reranker collection settings
Add experimental backoff for GRPC UNAVAILABLE error codes
Automatically pick up GRPC message size from Weaviate
Remove octoai vectorizer and generative methods. They are shutting down
Add baseURL and dimensions params to text2vec-jinaai by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1308
baseURL and dimensions params to text2vec-jinaai by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1308tenant and consistency_level to collection/base.pyi by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1327Sequence for list filtering to aid type usage by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1328return_properties={True, False} as equivalents to {None, []} by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1331Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.8.1...v4.9.0
Multi vector search for near_vector and hybrid
Backup cancellation
Vector search filter strategy (acorn)
Renaming *-palm to *-google for generative and vectorization modules.
Typing fixes
Bump of default embedded version to 1.26.6
Allow return_properties={True, False} as equivalents to {None, []}
Dependency updates
Nothing published for this version
Nothing published for this version
Suppress outdated warning emitted by auto-gened protobuf code by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1282
authlib below 1.3.2 until bug is fixed by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1293Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.8.0...v4.8.1
Suppresses warning emitted by protobuf library in relation to obsolate generated stubs
Fixes the authlib to <1.32.2 while a potential bug is investigated
Updates the validators dependency
Deprecate v3 in v4 by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1239
AdditionalConfig.trust_env correctly to httpx client by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1214cache_size param to .iterator() to make request size mutable by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1263generative-databricks support in Configure factory by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1273v4.8.0 change by @antas-marcin in https://github.com/weaviate/weaviate-python-client/pull/1280Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.7.1...v4.8.0
Mistral text2vec module
Friendli generative module
Databricks text2vec and generative modules
New fetch_objects_by_ids method
Support for hybrid search with vector distance
Fixes issue with adding a property on a vectorized collection
Bumps requests, importlib-metadata, pytest`, pytest-asyncio, types-requests, litestar and typing-extensions libs to newest versions
Do not use deps ranges in devel requirements by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1197
GRPC_VERBOSITY="ERROR" env var in __init__.py by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1196httpx client by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1206reranker-jinaai module by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1204Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.7.0...v4.7.1
This patch version includes:
Fixes log noise due to value of deprecated GRPC_VERBOSITY flag in underlying grpc library
Bumps requests and authlib versions to avoid security issues
Adds support for configuring the new reranker-jinaai module when creating collections
The query timeout now modifies the read= timeout in the httpx client for all GET, HEAD, and gql query requests
The insert timeout now modifies the read= timeout in the httpx client for all DELETE, POST, PATCH, and PUT requests
The init timeout now only modifies the timeouts in the httpx client for requests involved in the client.connect() method
Fix GQL injection vulnerability by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1134
weaviate.outputs by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1098py.typed file for type checking usage by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1112collections.create by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1119WeaviateAsyncClient as async alternative to WeaviateClient by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1007pq, bq, and sq with hnsw index by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1171BlockingIOError error logs emitted by aio.grpc in event loops by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1180tenants.update requests in batches of 100 by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1192v1.26 features and introduce WeaviateAsyncClient by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1133Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.6.4...v4.7.0
This minor version includes:
All methods that perform CRUD and search actions are now async def functions
async with weaviate.use_async_with_local() as client:
# Your codeclient = weaviate.use_async_with_local()
await client.connect()
# Your code
await client.close()A refactoring of the underlying implementation of the WeaviateClient to use the WeaviateAsyncClient under-the-hood scheduling the necessary coroutines to run in a side-car event-loop thread
Multi-vector search in the .near_x and .hybrid methods within the .generate and .query collection namespaces
Scalar Quantization (SQ) vector index configuration
Async replication configuration for multi-node Weaviate deployments
Tenant offloading to S3 cloud storage using the newly intrduced OFFLOADED tenant activity status
Renaming of HOT to ACTIVE and COLD to INACTIVE for tenant activity statuses
NOTE: To use these features, you must have Weaviate version 1.26.0 or higher
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Custom vectorizers by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1152
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.6.6...v4.6.7
This patch version includes:
Fix batching with references. Under some circumstances a reference could be added before its to-object and the reference would be lost.
Fix node status for timed out nodes
Fix parsing the year 0. While weaviate allows to add dates with year zero ("0000-01-30T00:00:00Z"), the datetime library is based on the gregorian calendar which does not have a year zero. The client will years with 0 as the minimum date that is possible in datetime (datetime.datetime(1, 1, 1, 0, 0)) and emit a warning
Support for custom rerankers and generative modules using Configure.Generative.custom() and Configure.Reranker.custom()
Add support for kagome_kr tokenizer. Requires Weaviate 1.25.8
Increase default embedded version to 1.25.8
Update Ollama module docstrings by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/1091
weaviate.outputs by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1098Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.6.4...v4.6.5
Addition of new voyageai embedding and rerank models as string literal types
Added missing exports of submodules in weaviate.outputs to aid usage
Updated ollama modules docstrings
Added missing py.typed file for use by static type checkers
Add huggingface integration by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1058
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.6.3...v4.6.4
Add support for auto-tenant-activation (available in Weaviate 1.25.2)
Pass dynamic quantizer inside hnsw/flat rather than at same level by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1066
_get_vector_v4 instead of _validate_input by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1077Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.6.2...v4.6.3
Removal of top-level validation of vector in data.insert, data.replace, and data.update. This validation occurs within the _get_vector_v4 method now instead.
Pass None instead of 'none' for no vectorizer_config when creating collections by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pul
None instead of 'none' for no vectorizer_config when creating collections by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1067Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.6.1...v4.6.2
Respect default vectorizer
Wait for Weaviate 1.25 to be ready before starting the embedded client
Add missing models for voyageai
Rename WCS to Weaviate Cloud and add new helper function weaviate.connect_to_weaviate_cloud
Fix sending module headers by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1062
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.6.0...v4.6.1
Fixes for client.integrations.configure
Better v3 deprecation warning by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1054
v1.25 support by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/973group_by parameter to bm25 and hybrid by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/978ListValue with BC by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/984tenants to use gRPC methods for get operations by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1031Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.5.7...v4.6.0
This minor version includes:
Support for Weaviate 1.25.0:
BM25/Hybrid support groupBy parameter
Hybrid supports MoveTo/MoveAwayFrom in near_vector and near_text through HybridVector class
Ollama text2vec and generative module
Octoai text2vec and generative module
multi2vev-palm module
dynamic vector index type
auto tenant creation
improved batching with vectorization
tenant exists endpoint
get tenant by name
Added client.integrations.configure to configure api-keys and model provider parameters for integration/module-providers without setting headers.
Improved error messages and deprecation warnings.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Deprecate all instances of bit_compression from the API by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1019
bit_compression from the API by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1019httpx to range between 0.25.0 and 0.27.0 by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1033Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.5.6...v4.5.7
This patch version includes:
Deprecation of the bit_compression field in the PQConfig class
Improvements to closing possibly open objects and connections
Enhances the WeaviateGRPCUnavailableError message with added context relevant to the user's environment
Relaxes the httpx requirements to aid compatability with other packages
Add after parameter to collection.iterator() by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/991
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.5.5...v4.5.6
This patch version includes:
Support for configuring collections with the new reranker-voyageai module
Providing an alpha parameter to collection.iterator() to control the beginning of the iteration
Update the default Timeout.init value from 1s to 2s
Fix node handling for shards when shards: null. by @jfrancoa in https://github.com/weaviate/weaviate-python-client/pull/990
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.5.4...v4.5.5
This patch version includes:
Bugfix when parsing the result from v1/nodes API with shards: null
Bugfix when parsing the result from v1/schema API with class.properties.moduleConfig: null and class.vectoriser: !'none'
Dependency bumps
Support last_update_time in nanoseconds by @jfrancoa in https://github.com/weaviate/weaviate-python-client/pull/960
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.5.3...v4.5.4
This patch version includes:
Fix parsing of creation/update time from old weaviate versions that write them in ns instead of ms
Support video_fields in multi2vec-palm which was added in Weaviate 1.24.4:
Add support for new modules by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/943
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.5.2...v4.5.3
This patch version includes:
Fix bug with hybrid searches without vector.
Support for new modules in Weaviate 1.24.2: - text2vec-voyageai - generative-mistral - Support new parameters for inference URLs in text2vec-transformers and multi2vec-clip
Support for new modules in Weaviate 1.24.3: - multi2vec-palm
Extend Tokenization enum options by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/934
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.5.1...v4.5.2
This patch version includes:
Fixes endpoint parameter for text2vec-palm
Adds support for GSE and TRIGRAM tokenizers
Add checks for empty lists for contains_any/all by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/917
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.5.0...v4.5.1
This patch version includes:
Filter.all_of([f1, f2]]) is a shortcut for f1 & f2
Filter.any_of([f1, f2]]) is a shortcut for f1 | f2
Can all be chained and mixed together to create dynamic and complex filters
Introduces weaviate.classes.init.Timeout class allowing to define the timeout used when performing client init checks, in addition to connect and query
Fixes a bug when performing contains_any/contains_all filtering using an empty list
Adds the ability to limit the top_occurences return when performing aggregation queries
Allows for defining gRPC proxying of the client and fixes the parsing of http and https proxies
Allow None as a query value in BM25 and hybrid queries
Fix missing named vectors support in data.update and data.replace
Reimplement support for updating named vector configurations alongside the patched 1.24.1 server version
Performance improvements by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/872
cluster_url input in connect_to_wcs by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/902Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.4.4...v4.5.0
This minor version includes:
Full support for the new named vectors feature available in the Weaviate 1.24 release.
Bugfixes to passing of Weaviate schema objects as collection configurations in certain edge cases.
Support use of Sagemaker when vectorizing with the text2vec-aws module.
Allow creation of collections that use the hnsw index with the bq quantizing strategy.
Allow specifying dimensions when vectorizing with the text2vec-openai module.
Python in-memory performance improvements when making queries .
Nothing published for this version
Fix validation of palm endpoint url by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/868
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.4.3...v4.4.4
This patch version includes:
A fix to the validation logic of the apiEndpoint field of GenerativePaLMConfig object.
Remove unneeded check by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/857
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.4.2...v4.4.3
This patch version includes
Fixes batching with references. Under some circumstances a reference could be added before its from-object and the reference would be lost.
Fixes readthedocs page
Small performance improvements for queries
strings update on new branch by @daveatweaviate in https://github.com/weaviate/weaviate-python-client/pull/845
hybrid(query: ...) type to Optional[str] by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/852Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.4.1...v4.4.2
This patch version includes
Fixes client.is_ready().
Adds option to skip input parameter validation if you need to squeeze out some extra performance.
All functions that accept vectors now also accept numpy arrays, tensorflow arrays and pandas/polars dataframes as input.
Hybrid search accepts None as query for a pure vector search.
Adds FilterValue to weaviate.outputs.
Allows group_by: str in aggregation queries.
Add 'aggregate' to wvc exports by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/841
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.4.0...v4.4.1
This patch version includes
Allows strings as input for groupBy arguments for aggregation.
Fixes for rate limit batching.
Your coding agent can read these notes before it upgrades. Set up the MCP server →