Add Python 3.14 support (#468)

## Summary

Add Python 3.14 support to RedisVL.

## Changes

- Update `requires-python` upper bound from `<3.14` to `<3.15`
- Add `Programming Language :: Python :: 3.14` classifier
- Add Python 3.14 to the CI test matrix

## Testing Strategy

**HuggingFace/sentence-transformers tests are skipped on Python 3.14**
because the upstream `transformers` library doesn't fully support Python
3.14 yet.

Affected components (all optional):
- `HFTextVectorizer`
- `HFCrossEncoderReranker`
- `SemanticRouter` (when using default HF vectorizer)
- `SemanticMessageHistory` (when using HF vectorizer)

Users can still use these features on Python 3.9-3.13, or use
alternative vectorizers (OpenAI, Cohere, etc.) on Python 3.14.

**Implementation:**
- Added `SKIP_HF` constant in `conftest.py` to detect Python 3.14+
- Skip HF-dependent test files entirely via `pytestmark`
- Skip individual HF tests via `@pytest.mark.requires_hf` marker
- Skip HF parameters in parametrized tests via `pytest.param(...,
marks=...)`

Once `transformers` adds Python 3.14 support, these skips can be
removed.

## Additional Fix

Added missing `@pytest.mark.requires_api_keys` marker to
`test_default_dtype` (pre-existing bug unrelated to this PR).

---------

Co-authored-by: Vishal Bala <vishalbala.1994@gmail.com>

Author: abrookins

.github/workflows/test.yml

@@ -62,7 +62,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
         redis-py-version: ["5.x", "6.x", "7.x"]
         redis-image: ["redis/redis-stack-server:latest", "redis:latest"]
     steps:

pyproject.toml

@@ -3,7 +3,7 @@ name = "redisvl"
 version = "0.14.0"
 description = "Python client library and CLI for using Redis as a vector database"
 authors = [{ name = "Redis Inc.", email = "applied.ai@redis.com" }]
-requires-python = ">=3.9.2,<3.14"
+requires-python = ">=3.9.2,<3.15"
 readme = "README.md"
 license = "MIT"
 keywords = [
@@ -19,6 +19,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "License :: OSI Approved :: MIT License",
 ]
 dependencies = [

tests/conftest.py

@@ -1,6 +1,7 @@
 import logging
 import os
 import subprocess
+import sys
 from datetime import datetime, timezone
 
 import pytest
@@ -9,7 +10,12 @@
 from redisvl.index.index import AsyncSearchIndex, SearchIndex
 from redisvl.redis.connection import RedisConnectionFactory, is_version_gte
 from redisvl.redis.utils import array_to_buffer
-from redisvl.utils.vectorize import HFTextVectorizer
+
+# Check if we're on Python 3.14+ where sentence-transformers may not work
+SKIP_HF = sys.version_info >= (3, 14)
+
+if not SKIP_HF:
+    from redisvl.utils.vectorize import HFTextVectorizer
 
 logger = logging.getLogger(__name__)
 
@@ -206,6 +212,8 @@ def cluster_client(redis_cluster_url):
 
 @pytest.fixture(scope="session")
 def hf_vectorizer():
+    if SKIP_HF:
+        pytest.skip("HFTextVectorizer not supported on Python 3.14+")
     return HFTextVectorizer(
         model="sentence-transformers/all-mpnet-base-v2",
         token=os.getenv("HF_TOKEN"),
@@ -215,11 +223,15 @@ def hf_vectorizer():
 
 @pytest.fixture(scope="session")
 def hf_vectorizer_float16():
+    if SKIP_HF:
+        pytest.skip("HFTextVectorizer not supported on Python 3.14+")
     return HFTextVectorizer(dtype="float16")
 
 
 @pytest.fixture(scope="session")
 def hf_vectorizer_with_model():
+    if SKIP_HF:
+        pytest.skip("HFTextVectorizer not supported on Python 3.14+")
     return HFTextVectorizer("sentence-transformers/all-mpnet-base-v2")
 
 
@@ -420,6 +432,10 @@ def pytest_configure(config: pytest.Config) -> None:
     config.addinivalue_line(
         "markers", "requires_cluster: mark test as requiring a Redis cluster"
     )
+    config.addinivalue_line(
+        "markers",
+        "requires_hf: mark test as requiring HuggingFace/sentence-transformers",
+    )
 
 
 def pytest_collection_modifyitems(
@@ -436,13 +452,18 @@ def pytest_collection_modifyitems(
     skip_cluster = pytest.mark.skip(
         reason="Skipping test because Redis cluster is not available. Use --run-cluster-tests to run these tests."
     )
+    skip_hf = pytest.mark.skip(
+        reason="Skipping test because sentence-transformers is not supported on Python 3.14+"
+    )
 
     # Apply skip markers independently based on flags
     for item in items:
         if item.get_closest_marker("requires_api_keys") and not run_api_tests:
             item.add_marker(skip_api)
         if item.get_closest_marker("requires_cluster") and not run_cluster_tests:
             item.add_marker(skip_cluster)
+        if item.get_closest_marker("requires_hf") and SKIP_HF:
+            item.add_marker(skip_hf)
 
 
 @pytest.fixture

tests/integration/test_cross_encoder_reranker.py

@@ -1,6 +1,13 @@
 import pytest
 
-from redisvl.utils.rerank.hf_cross_encoder import HFCrossEncoderReranker
+from tests.conftest import SKIP_HF
+
+if not SKIP_HF:
+    from redisvl.utils.rerank.hf_cross_encoder import HFCrossEncoderReranker
+
+pytestmark = pytest.mark.skipif(
+    SKIP_HF, reason="sentence-transformers not supported on Python 3.14+"
+)
 
 
 @pytest.fixture(scope="session")

tests/integration/test_llmcache.py

@@ -1,4 +1,5 @@
 import asyncio
+import sys
 import warnings
 from collections import namedtuple
 from time import sleep, time
@@ -10,8 +11,14 @@
 from redisvl.extensions.cache.llm import SemanticCache
 from redisvl.index.index import AsyncSearchIndex, SearchIndex
 from redisvl.query.filter import Num, Tag, Text
-from redisvl.utils.vectorize import HFTextVectorizer
-from tests.conftest import skip_if_no_redisearch, skip_if_no_redisearch_async
+from tests.conftest import SKIP_HF, skip_if_no_redisearch, skip_if_no_redisearch_async
+
+if not SKIP_HF:
+    from redisvl.utils.vectorize import HFTextVectorizer
+
+pytestmark = pytest.mark.skipif(
+    SKIP_HF, reason="sentence-transformers not supported on Python 3.14+"
+)
 
 
 @pytest.fixture(scope="session")

tests/integration/test_message_history.py

@@ -5,7 +5,11 @@
 
 from redisvl.extensions.constants import ID_FIELD_NAME
 from redisvl.extensions.message_history import MessageHistory, SemanticMessageHistory
-from tests.conftest import skip_if_no_redisearch
+from tests.conftest import SKIP_HF, skip_if_no_redisearch
+
+requires_hf = pytest.mark.skipif(
+    SKIP_HF, reason="sentence-transformers not supported on Python 3.14+"
+)
 
 
 @pytest.fixture
@@ -327,6 +331,7 @@ def test_standard_clear(standard_history):
 
 
 # test semantic message history
+@requires_hf
 def test_semantic_specify_client(client, hf_vectorizer):
     skip_if_no_redisearch(client)
     history = SemanticMessageHistory(
@@ -339,6 +344,7 @@ def test_semantic_specify_client(client, hf_vectorizer):
     assert isinstance(history._index.client, type(client))
 
 
+@requires_hf
 def test_semantic_bad_connection_info(hf_vectorizer):
     with pytest.raises(ConnectionError):
         SemanticMessageHistory(
@@ -349,6 +355,7 @@ def test_semantic_bad_connection_info(hf_vectorizer):
         )
 
 
+@requires_hf
 def test_semantic_scope(semantic_history):
     # store entries under default session tag
     semantic_history.store("some prompt", "some response")
@@ -376,6 +383,7 @@ def test_semantic_scope(semantic_history):
     assert no_context == []
 
 
+@requires_hf
 def test_semantic_store_and_get_recent(semantic_history):
     context = semantic_history.get_recent()
     assert len(context) == 0
@@ -461,6 +469,7 @@ def test_semantic_store_and_get_recent(semantic_history):
         bad_context = semantic_history.get_recent(top_k="3")
 
 
+@requires_hf
 def test_semantic_messages_property(semantic_history):
     semantic_history.add_messages(
         [
@@ -505,6 +514,7 @@ def test_semantic_messages_property(semantic_history):
     ]
 
 
+@requires_hf
 def test_semantic_add_and_get_relevant(semantic_history):
     semantic_history.add_message(
         {"role": "system", "content": "discussing common fruits and vegetables"}
@@ -580,6 +590,7 @@ def test_semantic_add_and_get_relevant(semantic_history):
         bad_context = semantic_history.get_relevant("test prompt", top_k="3")
 
 
+@requires_hf
 def test_semantic_get_raw(semantic_history):
     semantic_history.store("first prompt", "first response")
     semantic_history.store("second prompt", "second response")
@@ -591,6 +602,7 @@ def test_semantic_get_raw(semantic_history):
     assert raw[1]["content"] == "first response"
 
 
+@requires_hf
 def test_semantic_drop(semantic_history):
     semantic_history.store("first prompt", "first response")
     semantic_history.store("second prompt", "second response")
@@ -679,6 +691,7 @@ def create_same_type():
         )
 
 
+@requires_hf
 def test_vectorizer_dtype_mismatch(client, redis_url, hf_vectorizer_float16):
     skip_if_no_redisearch(client)
     with pytest.raises(ValueError):

tests/integration/test_rerankers.py

@@ -2,10 +2,14 @@
 
 import pytest
 
-from redisvl.utils.rerank import (
-    CohereReranker,
-    HFCrossEncoderReranker,
-    VoyageAIReranker,
+from redisvl.utils.rerank import CohereReranker, VoyageAIReranker
+from tests.conftest import SKIP_HF
+
+if not SKIP_HF:
+    from redisvl.utils.rerank import HFCrossEncoderReranker
+
+requires_hf = pytest.mark.skipif(
+    SKIP_HF, reason="sentence-transformers not supported on Python 3.14+"
 )
 
 
@@ -25,11 +29,15 @@ def reranker(request):
 
 @pytest.fixture
 def hfCrossEncoderReranker():
+    if SKIP_HF:
+        pytest.skip("HFCrossEncoderReranker not supported on Python 3.14+")
     return HFCrossEncoderReranker()
 
 
 @pytest.fixture
 def hfCrossEncoderRerankerWithCustomModel():
+    if SKIP_HF:
+        pytest.skip("HFCrossEncoderReranker not supported on Python 3.14+")
     return HFCrossEncoderReranker("cross-encoder/stsb-distilroberta-base")
 
 
@@ -76,6 +84,7 @@ def test_bad_input(reranker):
             )  # Invalid rank_by field
 
 
+@requires_hf
 def test_rank_documents_cross_encoder(hfCrossEncoderReranker):
     query = "I love you"
     texts = ["I love you", "I like you", "I don't like you", "I hate you"]
@@ -85,6 +94,7 @@ def test_rank_documents_cross_encoder(hfCrossEncoderReranker):
         assert scores[i] > scores[i + 1]
 
 
+@requires_hf
 def test_rank_documents_cross_encoder_custom_model(
     hfCrossEncoderRerankerWithCustomModel,
 ):
@@ -96,6 +106,7 @@ def test_rank_documents_cross_encoder_custom_model(
         assert scores[i] > scores[i + 1]
 
 
+@requires_hf
 @pytest.mark.asyncio
 async def test_async_rank_cross_encoder(hfCrossEncoderReranker):
     docs = ["document one", "document two", "document three"]

tests/integration/test_semantic_router.py

@@ -12,7 +12,11 @@
     RoutingConfig,
 )
 from redisvl.redis.connection import is_version_gte
-from tests.conftest import skip_if_no_redisearch, skip_if_redis_version_below
+from tests.conftest import SKIP_HF, skip_if_no_redisearch, skip_if_redis_version_below
+
+pytestmark = pytest.mark.skipif(
+    SKIP_HF, reason="sentence-transformers not supported on Python 3.14+"
+)
 
 
 def get_base_path():