Skip to content

v0.3.0

Choose a tag to compare

@tvanreenen tvanreenen released this 14 May 21:00
dfc7f3a

Summary

This release broadens numpy-vector-store from cosine-only search to a small exact vector-search API with explicit normalization semantics.

Highlights

  • Added normalize: bool = True to VectorStore, keeping normalized cosine search as the default behavior.
  • Added dot_search(...) for dot-product ranking.
  • Added euclidean_search(...) for nearest-neighbor distance ranking.
  • Added raw-vector mode with normalize=False for workloads where magnitude or original geometry matters.
  • Documented normalization behavior, method-selection guidance, and the behavior matrix for normalized vs raw storage.
  • Kept .npz persistence minimal with only vectors and metadata; callers should load with the intended normalize setting.

Breaking changes

  • Removed deprecated add_vectors(...).
  • Removed deprecated legacy search(...) tuple API.

Use add(...) and the explicit metric methods: cosine_search(...), dot_search(...), or euclidean_search(...).