NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #1173 most downloaded on PyPI
A python native Weaviate client
Last release 27 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
feat(generative): add location to GenerativeConfig.google_vertex runtime config ( #2073 ) by @Anai-Guo in #2130
Full Changelog: v4.23.0...v4.23.1
One column per quarter.
Add support for the new generative-digitalocean module
Add support for the centered RQ4 quantizer
Add location to the generative-google collection and runtime configurations
Add api_version to the generative-openai collection configuration for Azure deployments
Add top_p to the generative-nvidia and base_url to the generative-anthropic collection configurations
Add n to the generative-openai runtime configuration, for both the OpenAI and Azure factories
Add frequency_penalty to the generative-cohere runtime configuration
Fix stop_sequences being dropped by the generative-aws runtime configuration instead of being sent to the server
Fix KeyError: 'pq' when updating the quantizer on an HFresh vector index
Fix reference filter builders mutating their target path, so a builder could not be reused
Fix client-side batching flushing early when only one of its two object counts was unchanged
Fix rate-limit spacing for partial batches
Accept a plain string API key in all sync and async connection helpers
Document vectorize_collection_name as having no effect on the multi2vec factories
feat: add optional location parameter to text2vec-google vectorizer by @g-despot in #2075
INTEGRATING enum to ReplicateOperationState by @tsmith023 in #2085time.sleep in async wait_for_weaviate by @kratos0718 in #2104Full Changelog: v4.22.0...v4.23.0
Add support for the cross-property And operator in keyword queries through BM25Operator.and_cross(), where each query token must be matched by at least one of the searched properties instead of all tokens occurring within a single property
Add support for diversity selection in hybrid queries via the diversity_selection parameter
Add support for the new multi2vec-twelvelabs vectorizer module
Add support for the new generative-deepseek module
Add dimensions to the text2vec-aws vectorizer configuration
Add location to the text2vec-google vectorizer configuration
Add endpoint to the text2vec-openai and text2vec-morph vectorizer configurations
Add incremental_base_backup_id to BackupListReturn
Add INTEGRATING to ReplicateOperationState
Fix has_errors not being set on batch.stream returns when individual objects or references failed
Fix tenants.activate(), tenants.deactivate() and tenants.offload() not returning their result in the async client, so they could not be awaited properly
Fix collections.exists() in the async client swallowing non-404 errors and returning False instead of raising
Fix blocking of the event loop when the async client waits for Weaviate to become ready
Include the gRPC status code in delete_many error messages
Fix validation of Sequence[Union[...]] inputs, which previously passed if only one element matched
Reject boolean values where an integer is expected in configuration and timeout validation
feat: Add Boost API by @trengrj in #2030
Full Changelog: v4.21.3...v4.22.0
Add support for the new Boost API for fine-grained, query-time relevance tuning — a boost parameter is now available across the vector, keyword (bm25), and hybrid query and generative-query methods
The Boost factory (exported from weaviate.classes.query alongside BoostReturn) provides numeric_property, filter, numeric_decay, time_decay, and blend boosts, each with optional depth and weight controls
fix(timeout): respect insertion timeout from config for fixed_batch by @jpsoultanis in #2048
Full Changelog: v4.21.2...v4.21.3
Fixes a bug where client-side batching contexts did not respect user-supplied insert timeouts
Fix aggregate metrics returning 0/0.0 instead of None for empty result sets by @dudanogueira in #2037
Full Changelog: v4.21.1...v4.21.2
Fix aggregate metrics returning 0/0.0 instead of None for empty result sets
Add text2vec-digitalocean vectorizer module
Send empty vector index type on new Weaviate versions to support default vector index type configuration on the server side
Support 1.37 features by @tsmith023 in #1988
Add support for the new blobHash property data type
Add support for returning profiling when making queries with the return_metadata=["query_profile"] parameter
Add support for on-demaned tokenization through the client.tokenize namespace
Add support for managing permissions for accessing the native MCP server
Add support for collection export
Add support for incremental backups
Change alpha queries and aggregations to use server-side default parameter
Fixes rare flakey behaviour of client.batch.stream on server hangup
Nothing published for this version
fix(deps): remove unmaintained deprecation package, use stdlib instead by @NIK-TIGER-BILL in #1999
Full Changelog: v4.20.4...v4.20.5
Fix objectTTL config export
Add support for audio modality in multi2vec-google
Export FilterReturn from weaviate.classes.query
Fix updating async replication config
Remove unmaintained deprecated dependency
Throw exception on empty time filters
Add client version to GRPC headers by @dirkkul in #1980
Full Changelog: v4.20.3...v4.20.4
Include client version in GRPC requests
Add support for the new multi2vec_google_gemini module
Bump authlib to 1.6.9 to avoid high cve by @tsmith023 in #1975
Full Changelog: v4.20.2...v4.20.3
Update of authlib dependency
perf: use deque for iterator object cache by @giulio-leone in https://github.com/weaviate/weaviate-python-client/pull/1968
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.20.1...v4.20.2
Support for incremental backups
Fix empty list filter raising IndexError instead of WeaviateInvalidInputError by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.20.0...v4.20.1
Raise an input error when filtering on an empty list
Remove cache option from SQConfig, deprecate field in factory method by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1954
collection.data.ingest for sync/async SSB usage by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1876Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.19.4...v4.20.0
Server-side batching (SSB) is now GA via batch.stream (batch.experimental is deprecated)
Add collection.data.ingest as a new entry point for SSB usage in sync and async clients
Add support for the new HFresh index type
Add support for async replication configuration
Add support for cancelling backup restore operations
Add collection.config.delete_property_index to drop filterable, searchable, or range filter indices from properties
Add client.cluster.statistics() method for retrieving cluster and Raft statistics
Allow images and image_properties in Cohere generative config at runtime
Provide options to specify custom gRPC SSL credentials for advanced connection setups
Remove cache option from SQConfig and deprecate the field in the factory method
Fix validation of nested object properties to allow id as a nested property name
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add gRPC ping check to is_live method by @sylvinho81 in https://github.com/weaviate/weaviate-python-client/pull/1949
collection.exists() if status code is not 404 by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1950Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.19.3...v4.19.4
Adds the gRPC healthcheck ping to the is_live() method of the async client to provide a more accurate check of the connection status of the async client
Fixes bug where exceptions raised in collections.exists() were silently ignored and the method would return False instead of raising the exception
Client telemetry by @parkerduckworth in https://github.com/weaviate/weaviate-python-client/pull/1909
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.19.2...v4.19.3
Add support for VoyageAI voyage-4 model family (voyage-4, voyage-4-lite, voyage-4-large)
A fix for async client connection issues when pypi is down
Revert #1915; not yet merged into Weaviate server
Revert #1915; not yet merged into Weaviate server
This patch version includes: - Revert merging #1915; not yet merged into Weaviate server
Add support for time-to-live (TTL) on objects
This minor version includes:
multi2multivec-weaviate moduleReorder overloads to remove deprecation warning in pycharm by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1901
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.18.2...v4.18.3
Fixes wrong deprecation warning in PyCharm when creating a collection without vectorizers
Fixes warnings with boolean filters
Mark 'ChunkSize' as deprecated & exclude it from export by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/1886
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.18.1...v4.18.2
Add support for contextual generative and reranker modules
Add support for ZSTD compression in backups
Add support for VoyageAI's voyage-3-large model
Add dimensions parameters for cohere vectorizers
dimensions parameters for cohere vectorizers (#1875)dimensions parameters for text2vec-voyage (#1870)Add 'dimensions' param to cohere vectorizers (feat/cohere-dimensions-param)
Add 'dimensions' parameter to text2vec-voyageai methods (feat/t2v-voyage-add-dimensions)
feat: add return fields for list backups and support ordering by @gkampitakis in https://github.com/weaviate/weaviate-python-client/pull/1856
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.17.0...v4.18.0
1-bit rotational quantization (RQ) for hnsw indices
1-bit and 8-bit RQ for flat indices
Support for latest preview release of Server-side Batching (SSB)
Allow sorting backups by creation time
Add support for gse_ch tokenizer
Nothing published for this version
Add note re GPT4All deprecation by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/1825
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.9...v4.17.0
Remove support for Weaviate versions < 1.27. Please update your Weaviate instances
OIDC group support in RBAC
Uncompressed quantizer
ContainsNone and Not filter operators
Add support for verbosity and reasoning effort for generative-openai module
Add alias.exists method
Add multi2vec-aws and text2vec-morph modules
Add support for max_tokens for generative-aws module
Fix weaviate client installation with other packages depending on grpc-health-checking
Nothing published for this version
Nothing published for this version
Add note re GPT4All deprecation by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/1825
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.9...v4.16.10
Addition of helper to create an uncompressed quantizer for use when not using default compression
Support for overwrite_alias option to backup create/restore
Support for OIDC groups
Addition of multi2vec-aws and text2vec-morph modules
Support for alias.exists method
Update to weaviate-agents-client dependency for GA release of agents
Deprecate broken method by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1795
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.8...v4.16.9
Explicitly depend on protobuf package
Add backup list endpoint by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1785
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.7...v4.16.8
Further attempted fixes for protobuf compatability issues
Introduction of the backups.list() method
Deprecate min_occurrences and add limit to Metrics.text by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/1756
min_occurrences and add limit to Metrics.text by @databyjp in https://github.com/weaviate/weaviate-python-client/pull/1756Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.6...v4.16.7
Fixes compatability issues between the built gRPC stubs and differing protobuf versions depending on the version of grpcio used to build the stubs
Add text2vec-model2vec module to Configure.NamedVectors
Deprecated min_occurrences in Metrics.text in favour of limit
Deprecate contextionar, add model2vec and dimension parameter for transformers by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/…
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.5...v4.16.6
Add dimensions property to text2vec-transformers vectorizers in Configure.Vectors
Add text2vec-model2vec vectorizer in Configure.Vectors
Deprecate text2vec-contextionary vectorizer
Add dimensions property to Google vectorizers in Configure.Vectors by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1767
dimensions property to Google vectorizers in Configure.Vectors by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1767Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.4...v4.16.5
Add dimensions property to Google vectorizers in Configure.Vectors
Remove unused configs from new vectorizer syntax by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1755
True for vectorize_collection_name in _Vectors and _MultiVectors by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1757Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.3...v4.16.4
Changes default value for vectorize_collection_name to True in new methods of Configure.Vectors and Configure.MultiVectors - This is a short-term fix to implicit default behaviour that is caused by an server-side issue - Once that is resolved, then this default will be changed back to False in a future release
Add support for protobuf v4+5+6 by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1682
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.2...v4.16.3
Fix for dates with nananosecond precision
Relax requirements for grcp dependencies and support protobuf 4, 5 and 6
Rename model_id to model in google vectorizers by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1747
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.1...v4.16.2
Renames model_id to model in Configure.Vectors
fix(rbac): Capitalize first letter for alias similar to collection by @kavirajk in https://github.com/weaviate/weaviate-python-client/pull/1741
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.16.0...v4.16.1
Fixes capitalization of alias permissions
Changes default value for vectorize_collection_name back to True in deprecated methods Configure.Vectorizer and Configure.NamedVectors
Add rescore_limit to RQ configuration
fix: auto capitalize target collection in by_ref_multi_target by @melsonic in https://github.com/weaviate/weaviate-python-client/pull/1471
v1.32 by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1727Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.15.4...v4.16.0
collection aliasing
replica movement
RQ configuration
Restoring of users and RBAC roles from backups
Support for the new multi2multivec-jinaai module
Usage of Configure.MultiVectors is reserved for modules like text2multivec-jinaai, which was previously known as text2colbert-jinaai
Addition of helper methods for updating tenant activity statuses: collection.tenants.activate(), collection.tenants.deactivate() and collection.tenants.offload()
Deprecate usage of OIDC with WCD by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1696
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.15.3...v4.15.4
Adds deprecation warning for connecting to Weaviate Cloud (WCD) using OIDC. Support for this will be removed in early August, please switch to using API keys instead.
Allow wider range of authlib by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1693
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.15.2...v4.15.3
Allows newer versions of authlib as dependency
pass error details in async client search by @augustas1 in https://github.com/weaviate/weaviate-python-client/pull/1690
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.15.1...v4.15.2
Fixes adding the original weaviate error message to our exceptions for async client
Fix: Update (soon to be) deprecated model_fields access to use class reference by @upDJ in https://github.com/weaviate/weaviate-python-client/pull/168…
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.15.0...v4.15.1
Adds the original weaviate error message to our exceptions
Allow adding vectors using collection.config.add_vector by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1640
collection.config.add_vector by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1640Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.14.4...v4.15.0
Support for new 1.31 features: - Adding new named vectors to existing collections - Support for bm25 operators - Mueva configuration
Fixes config.get() for multivector collections
Copy context to ensure open telemetry makes it to batch requests
Update cohere models
Update voyageai models
Update embedded version to 1.30.5
Fix storage location for embedded mode
Add agents docs to the readthedocs page
Add support for extracting nested object array properties from data models by @jstol in https://github.com/weaviate/weaviate-python-client/pull/1671
connect_to_x helpers by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1661Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.14.3...v4.14.4
Fixes interfaces for user.db/oidc
If a string is passed into auth= we assume that it is an api-key
Fix extracting nested array properties from data models
Permit vector: list[list[float32]] in .hybrid by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1664
vector: list[list[float32]] in .hybrid by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1664Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.14.1...v4.14.3
Fixes return type for aggregate with group_by and zero results
Fix multi-vector with hybrid search
Order return of collections.list_all() alphabetically by key by @saireddythfc in https://github.com/weaviate/weaviate-python-client/pull/1636
query.bm25 by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1656Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.14.0...v4.14.1
Fixes a missing typing.overload specification for the query.bm25 method
Stefan/readthedocs update by @StefanBogdan in https://github.com/weaviate/weaviate-python-client/pull/1568
self._connected at end of .connect() method by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1639v4.14.0 by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1652Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.13.2...v4.14.0
All docstrings have been aligned with Google's style format
The read-the-docs page has been streamlined and improved for ease of use: https://weaviate-python-client.readthedocs.io/en/stable/
Fixes a bug when adding a property to a collection configured with both named vectors and a generative module
Potential fixes for race conditions when instantiating async clients
A number of minor fixes to the public .pyi stub files found by developing a stub auto-generating tool for the codebase
Fix accidental adding of / to all AnyHttpUrl models in grpc gen.conf. by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1628
/ to all AnyHttpUrl models in grpc gen.conf. by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1628Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.13.1...v4.13.2
Fixes a parsing bug when providing URLs with GenerativeConfig for runtime generate queries
Add missing default value by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1625
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.13.0...v4.13.1
Fixes generative.near_text() to not require generative_provider
Refactor to separate sync and async connections by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1594
Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.12.1...v4.13.0
Introduction of a dependency injection system whereby the sync/async connections are injected into each client independently thereby removing their cross-dependency.
Removal of the event_loop.py file and all logic surrounding its usage by the sync client.
Refactoring of the batching algorithm to use blocking threads with a sync connection, rather than the event loop sidecar thread.
Nothing published for this version
Rename openai_azure in GenerativeConfig to azure_openai by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1623
openai_azure in GenerativeConfig to azure_openai by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1623Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.12.0...v4.12.1
Renames GenerativeConfig.openai_azure to GenerativeConfig.azure_openai to align with the convention of Configure.Generative.azure_openai
Dynamic users: single calls for deprecated functions by @dirkkul in https://github.com/weaviate/weaviate-python-client/pull/1597
get_by_name to use TenantGetOne REST endpoint by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1617tenant option to Permissions.data and Permissions.tenants by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1593Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.11.3...v4.12.0
Dynamic user management of OIDC and native DB users
Improved multi-dimensional/colBERT vectors
Query-time configuration of generative modules
Tenant-based filtering of data permissions in RBAC
The new generative-xai module
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix collision between waiting_count and backoff_count when looping by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1604
v4.11.3 by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1606Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.11.2...v4.11.3
Fixes a rare bug when the batching algorithm waits for async indexing to complete far beyond the maximum number of allowed retries
Removes the sync-in-async warning emitted by the sync client when used in an async context due to the warning being erroneously emitted in notebooks
Fix missing parameters in certain modules, align all text2vec docstrings by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1587
UNAVAILABLE to grpc batch objects by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1582multivector.enabled==False then return None by @tsmith023 in https://github.com/weaviate/weaviate-python-client/pull/1596Full Changelog: https://github.com/weaviate/weaviate-python-client/compare/v4.11.1...v4.11.2
This is used in the batching algorithm and in data.insert_many
Max number of retries is configurable using the WEAVIATE_BATCH_MAX_RETRIES env var
Adds support for OIDC when using the text2vec-weaviate module
Adds support for updating descriptions of properties in collections (needs compatible server version)
Adds warning recommending to refactor to use AsyncClient if the SyncClient is used in an async context
Fixes bugs when importing/exporting collection configurations with respect to property module configs
Fixes bug when exporting config with multivector enabled between versions
Your coding agent can read these notes before it upgrades. Set up the MCP server →