diff --git a/.github/workflows/main.yaml b/.github/workflows/main.yaml
index 233e708d5..cfdb969e4 100644
--- a/.github/workflows/main.yaml
+++ b/.github/workflows/main.yaml
@@ -63,7 +63,7 @@ jobs:
strategy:
fail-fast: false
matrix:
- version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+ version: ["3.11", "3.12", "3.13", "3.14", "3.15"]
folder: ["weaviate", "integration", "integration_embedded"]
steps:
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -84,7 +84,7 @@ jobs:
strategy:
fail-fast: false
matrix:
- version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+ version: ["3.11", "3.12", "3.13", "3.14", "3.15"]
folder: ["test", "mock_tests"]
steps:
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -96,7 +96,7 @@ jobs:
- name: Run unittests
run: pytest --cov -v --cov-report=term-missing --cov=weaviate --cov-report xml:coverage-${{ matrix.folder }}.xml ${{ matrix.folder }}
- name: Archive code coverage results
- if: matrix.version == '3.10' && (github.ref_name != 'main')
+ if: matrix.version == '3.11' && (github.ref_name != 'main')
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
with:
name: coverage-report-${{ matrix.folder }}
@@ -188,7 +188,7 @@ jobs:
timeout-minutes: 30
strategy:
matrix:
- version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+ version: ["3.11", "3.12", "3.13", "3.14", "3.15"]
optional_dependencies: [false]
steps:
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
@@ -206,7 +206,7 @@ jobs:
if: ${{ !github.event.pull_request.head.repo.fork }}
run: pytest -v --cov --cov-report=term-missing --cov=weaviate --cov-report xml:coverage-integration-embedded.xml integration_embedded
- name: Archive code coverage results
- if: matrix.version == '3.10' && (github.ref_name != 'main') && !github.event.pull_request.head.repo.fork
+ if: matrix.version == '3.11' && (github.ref_name != 'main') && !github.event.pull_request.head.repo.fork
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
with:
name: coverage-report-integration-embedded
@@ -220,13 +220,13 @@ jobs:
fail-fast: false
matrix:
versions: [
- { py: "3.10", weaviate: $WEAVIATE_140, grpc: "1.59.5", protobuf: "4.25.9"},
- { py: "3.11", weaviate: $WEAVIATE_140, grpc: "1.66.0", protobuf: "5.29.6"},
+ { py: "3.11", weaviate: $WEAVIATE_140, grpc: "1.59.5", protobuf: "4.25.9"},
{ py: "3.12", weaviate: $WEAVIATE_140, grpc: "1.70.0", protobuf: "5.29.6"},
{ py: "3.13", weaviate: $WEAVIATE_140, grpc: "1.72.1", protobuf: "6.33.6"},
{ py: "3.14", weaviate: $WEAVIATE_140, grpc: "1.76.0", protobuf: "6.33.6"},
{ py: "3.14", weaviate: $WEAVIATE_140, grpc: "1.85.0", protobuf: "6.33.6"},
- { py: "3.14", weaviate: $WEAVIATE_140, grpc: "1.85.0", protobuf: "7.36.2"}
+ { py: "3.14", weaviate: $WEAVIATE_140, grpc: "1.85.0", protobuf: "7.36.2"},
+ { py: "3.15", weaviate: $WEAVIATE_140, grpc: "1.85.0", protobuf: "7.36.2"}
]
optional_dependencies: [false]
steps:
@@ -262,7 +262,7 @@ jobs:
if: ${{ github.event.pull_request.head.repo.fork || github.triggering_actor == 'dependabot[bot]' }}
run: pytest -n auto --dist loadgroup -v --cov --cov-report=term-missing --cov=weaviate --cov-report xml:coverage-integration.xml integration
- name: Archive code coverage results
- if: matrix.versions.py == '3.10' && (github.ref_name != 'main')
+ if: matrix.versions.py == '3.11' && (github.ref_name != 'main')
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
with:
name: coverage-report-integration
@@ -278,18 +278,18 @@ jobs:
fail-fast: false
matrix:
versions: [
- { py: "3.10", weaviate: $WEAVIATE_140},
{ py: "3.11", weaviate: $WEAVIATE_140},
{ py: "3.12", weaviate: $WEAVIATE_140},
{ py: "3.13", weaviate: $WEAVIATE_140},
- { py: "3.14", weaviate: $WEAVIATE_140}
+ { py: "3.14", weaviate: $WEAVIATE_140},
+ { py: "3.15", weaviate: $WEAVIATE_140}
]
optional_dependencies: [false]
steps:
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
- uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
with:
- python-version: "3.11"
+ python-version: ${{ matrix.versions.py }}
cache: 'pip' # caching pip dependencies
- name: Login to Docker Hub
uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121 # v4
diff --git a/README.rst b/README.rst
index 3f45a3d3b..1f1fc366f 100644
--- a/README.rst
+++ b/README.rst
@@ -19,7 +19,7 @@ Weaviate python client
A python native client for easy interaction with a Weaviate instance.
-The client is tested for python 3.9 and higher.
+The client is tested for python 3.11 and higher.
Visit the official `Weaviate `_ website for more information about the Weaviate and how to use it in production.
diff --git a/docs/changelog.rst b/docs/changelog.rst
index 1e0c98c56..ea8735ba2 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -6,6 +6,8 @@ Version 4.25.0
This minor version includes:
- Remove support for Weaviate versions < 1.32.0. Connecting to an older server now raises ``WeaviateStartUpError`` even with ``skip_init_checks=True``. Please update your Weaviate instances
- Support ``protobuf`` 7
+ - Remove support for Python 3.10, which reached its end of life in October 2026. The client now requires Python 3.11 or newer
+ - Support Python 3.15
- Remove the legacy GraphQL aggregation path together with the ``weaviate.gql`` and ``weaviate.error_msgs`` modules, ``weaviate.util.is_weaviate_too_old`` and ``weaviate.util.MINIMUM_NO_WARNING_VERSION``, and the ``weaviate.AdditionalProperties`` and ``weaviate.LinkTo`` attributes (which already pointed at names that did not exist). Aggregations always use gRPC now. ``client.graphql_raw_query()`` is unchanged
Version 4.24.1
diff --git a/docs/index.rst b/docs/index.rst
index 2b004e62c..820a92c96 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -15,7 +15,7 @@ Welcome to Weaviate Python Client's documentation!
|build-status| |pypi-version|
-The Weaviate Python client makes it easy to work with `Weaviate `_, an AI Native vector database. The client is tested for Python 3.8 and higher.
+The Weaviate Python client makes it easy to work with `Weaviate `_, an AI Native vector database. The client is tested for Python 3.11 and higher.
The current major version is **v4** while the older **v3** client is deprecated and should be avoided. You can find further documentation for both versions:
diff --git a/packages/web/pyproject.toml b/packages/web/pyproject.toml
index 0f4872e18..e9520377e 100644
--- a/packages/web/pyproject.toml
+++ b/packages/web/pyproject.toml
@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
name = "weaviate-client-web"
description = "grpc-web / WASM (Pyodide) transport for the Weaviate Python client"
readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
license = { text = "BSD-3-Clause" }
authors = [{ name = "Weaviate", email = "hello@weaviate.io" }]
keywords = ["weaviate", "grpc-web", "pyodide", "wasm", "emscripten"]
diff --git a/profiling/__init__.py b/profiling_tests/__init__.py
similarity index 100%
rename from profiling/__init__.py
rename to profiling_tests/__init__.py
diff --git a/profiling/conftest.py b/profiling_tests/conftest.py
similarity index 97%
rename from profiling/conftest.py
rename to profiling_tests/conftest.py
index f99cf6bc1..5681355f8 100644
--- a/profiling/conftest.py
+++ b/profiling_tests/conftest.py
@@ -20,10 +20,10 @@
def get_file_path(file_name: str) -> str:
- if not os.path.exists(file_name) and not os.path.exists("profiling/" + file_name):
+ if not os.path.exists(file_name) and not os.path.exists("profiling_tests/" + file_name):
pytest.skip("data does not exist")
- if os.path.exists("profiling/" + file_name):
- file_name = "profiling/" + file_name
+ if os.path.exists("profiling_tests/" + file_name):
+ file_name = "profiling_tests/" + file_name
return file_name
diff --git a/profiling/constants.py b/profiling_tests/constants.py
similarity index 100%
rename from profiling/constants.py
rename to profiling_tests/constants.py
diff --git a/profiling/pyspy.py b/profiling_tests/pyspy.py
similarity index 100%
rename from profiling/pyspy.py
rename to profiling_tests/pyspy.py
diff --git a/profiling/test_import_and_query.py b/profiling_tests/test_import_and_query.py
similarity index 100%
rename from profiling/test_import_and_query.py
rename to profiling_tests/test_import_and_query.py
diff --git a/profiling/test_profiling.py b/profiling_tests/test_profiling.py
similarity index 98%
rename from profiling/test_profiling.py
rename to profiling_tests/test_profiling.py
index 4c4d7cb9e..526ec2e00 100644
--- a/profiling/test_profiling.py
+++ b/profiling_tests/test_profiling.py
@@ -1,6 +1,6 @@
# run:
-# - profiling: pytest -m profiling profiling/test_profiling.py --profile-svg
-# - benchmark: pytest profiling/test_profiling.py --benchmark-only --benchmark-disable-gc
+# - profiling: pytest -m profiling profiling_tests/test_profiling.py --profile-svg
+# - benchmark: pytest profiling_tests/test_profiling.py --benchmark-only --benchmark-disable-gc
import concurrent.futures
import math
import uuid
diff --git a/profiling/test_refs.py b/profiling_tests/test_refs.py
similarity index 100%
rename from profiling/test_refs.py
rename to profiling_tests/test_refs.py
diff --git a/profiling/test_shutdown.py b/profiling_tests/test_shutdown.py
similarity index 100%
rename from profiling/test_shutdown.py
rename to profiling_tests/test_shutdown.py
diff --git a/profiling/test_sphere.py b/profiling_tests/test_sphere.py
similarity index 100%
rename from profiling/test_sphere.py
rename to profiling_tests/test_sphere.py
diff --git a/requirements-devel.txt b/requirements-devel.txt
index 48a3ae3e5..6e4e5c520 100644
--- a/requirements-devel.txt
+++ b/requirements-devel.txt
@@ -1,10 +1,15 @@
httpx==0.26.0
validators==0.34.0
authlib==1.9.1
-grpcio==1.75.1
-grpcio-tools==1.75.1
-grpcio-health-checking==1.75.1
-pydantic==2.12.0
+# Python 3.15 needs the first releases with cp315 wheels; older ones build from source.
+grpcio==1.75.1; python_version < "3.15"
+grpcio-tools==1.75.1; python_version < "3.15"
+grpcio-health-checking==1.75.1; python_version < "3.15"
+pydantic==2.12.0; python_version < "3.15"
+grpcio==1.84.0; python_version >= "3.15"
+grpcio-tools==1.84.0; python_version >= "3.15"
+grpcio-health-checking==1.84.0; python_version >= "3.15"
+pydantic==2.14.0; python_version >= "3.15"
packaging==26.2
build
@@ -20,7 +25,7 @@ importlib_metadata==8.7.0
tomli==2.4.0
types-protobuf==6.30.2.20250703
types-urllib3==1.26.25.14
-typing_extensions==4.15.0
+typing_extensions==4.16.0
pre-commit
flake8
diff --git a/setup.cfg b/setup.cfg
index 26075543d..6b3daa241 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -43,7 +43,7 @@ install_requires =
grpcio>=1.59.5,<2.0.0; sys_platform != "emscripten"
protobuf>=4.21.6,<8.0.0
packaging>=21.0
-python_requires = >=3.10
+python_requires = >=3.11
[options.extras_require]
agents =
diff --git a/weaviate/collections/classes/grpc.py b/weaviate/collections/classes/grpc.py
index 4b0f003c2..d3b701d2b 100644
--- a/weaviate/collections/classes/grpc.py
+++ b/weaviate/collections/classes/grpc.py
@@ -2,7 +2,6 @@
from datetime import datetime, timedelta, timezone
from enum import Enum, auto
from typing import (
- Any,
Dict,
Generic,
List,
@@ -644,8 +643,7 @@ def mmr(limit: Optional[int] = None, balance: Optional[float] = None) -> MMR:
@dataclass
class BM25OperatorOptions:
- # replace with ClassVar[base_search_pb2.SearchOperatorOptions.Operator] once python 3.10 is removed
- operator: ClassVar[Any]
+ operator: ClassVar[base_search_pb2.SearchOperatorOptions.Operator]
@dataclass
diff --git a/weaviate/collections/classes/internal.py b/weaviate/collections/classes/internal.py
index b1c04077d..6fd63732b 100644
--- a/weaviate/collections/classes/internal.py
+++ b/weaviate/collections/classes/internal.py
@@ -1,8 +1,8 @@
import datetime
-import sys
import uuid as uuid_package
from dataclasses import dataclass, field
from typing import (
+ Annotated,
Any,
Dict,
Generic,
@@ -14,15 +14,13 @@
Type,
Union,
cast,
+ get_args,
+ get_origin,
+ get_type_hints,
)
from typing_extensions import TypeAlias, deprecated
-if sys.version_info < (3, 9):
- from typing_extensions import Annotated, get_args, get_origin, get_type_hints
-else:
- from typing import Annotated, get_args, get_origin, get_type_hints
-
from weaviate.collections.classes.generative import (
_GenerativeConfigRuntime,
_GenerativeConfigRuntimeOptions,
diff --git a/weaviate/util.py b/weaviate/util.py
index b06978b8c..52b24b2ef 100644
--- a/weaviate/util.py
+++ b/weaviate/util.py
@@ -22,7 +22,7 @@
UnexpectedStatusCodeError,
WeaviateInvalidInputError,
)
-from weaviate.types import BLOB_INPUT, NUMBER, TIME, UUIDS
+from weaviate.types import BLOB_INPUT, NUMBER, TIME, UUID, UUIDS
from weaviate.warnings import _Warnings
PYPI_PACKAGE_URL = "https://pypi.org/pypi/weaviate-client/json"
@@ -670,9 +670,7 @@ def _type_request_response(json_response: Any) -> Optional[Dict[str, Any]]:
def _to_beacons(uuids: UUIDS, to_class: str = "") -> List[Dict[str, str]]:
- if isinstance(uuids, uuid_lib.UUID) or isinstance(
- uuids, str
- ): # replace with isinstance(uuids, UUID) in 3.10
+ if isinstance(uuids, UUID):
uuids = [uuids]
if len(to_class) > 0: