Skip to content

4.17.0 — 2026-07-15

← 4.16.0 | ↑ 4.x series

Added

Adapters - Redis

  • Vector Range Search - Added vector range queries via RangeQueryDTO and SearchQueryDTO.from_range(), executed through sync and async RediSearch handles with optional metadata filters and score fields.
  • Vector Query Runtime Tuning - Added VectorQueryRuntimeDTO for per-query KNN, range, and hybrid tuning (ef_runtime, epsilon, batch_size, search_window_size, hybrid_policy, use_search_history, search_buffer_capacity, and cluster-only shard_k_ratio).
  • SVS-VAMANA Index Support - Extended vector index creation with VectorAlgorithm.SVS_VAMANA, including compression, construction window, graph degree, search window, training threshold, and reduce attributes validated at schema time.
  • RediSearch Cluster Support - RediSearch handles now work on standalone and cluster clients; cluster index listing routes keyless admin commands to a target node, and hash-tagged key prefixes keep indexed documents in a single slot.
  • Index Listing - Added list_search_indexes() on sync and async Redis adapters, backed by list_redis_search_indexes / list_redis_search_indexes_async.

Models - DTOs

  • Vector Query DTOs - Added VectorQueryRuntimeDTO and RangeQueryDTO; extended KnnQueryDTO and SearchQueryDTO with range, runtime, is_range, and from_range() factory helpers.

Models - Types

  • Vector Search Types - Added VectorType (BFLOAT16, FLOAT16, FLOAT32, FLOAT64, INT8, UINT8), VectorCompression (LVQ and LeanVec variants), VectorHybridPolicy (BATCHES, ADHOC_BF), and UseSearchHistory (OFF, ON, AUTO); extended VectorAlgorithm with SVS_VAMANA.

Changed

Adapters - Redis

  • Vector Field Schema Validation - VectorFieldConfig now rejects algorithm-incompatible tuning attributes (FLAT vs HNSW vs SVS-VAMANA) and limits SVS-VAMANA to FLOAT16 and FLOAT32 vector types.

Models - DTOs

  • Vector Field Configuration - Extended VectorFieldConfig with vector_type, HNSW tuning (m, ef_construction, ef_runtime, epsilon), and SVS-VAMANA tuning fields for index-time configuration.

Tests

Tests - Redis Adapter

  • Vector Search Scenarios - Extended features/redis_adapter.feature and step definitions with SVS-VAMANA index creation, vector range search, and runtime-tuning coverage for sync RediSearch operations.

Documentation

Tutorials - Redis

  • Vector Search Guide - Expanded the Redis adapter tutorial with SVS-VAMANA and HNSW tuning, cluster index prefixes, vector range queries, hybrid search on cluster, and VectorQueryRuntimeDTO examples.

API Reference

  • Updated mkdocstrings entries for Redis search DTOs and redis_search_types to cover new vector types, range queries, and runtime parameters.