voyager 2.2.0__tar.gz

voyager-2.2.0/CMakeLists.txt

@@ -0,0 +1,86 @@
+cmake_minimum_required(VERSION 3.15...3.27)
+project(voyager LANGUAGES CXX)
+
+# Warn if the user invokes CMake directly
+if (NOT SKBUILD)
+  message(WARNING "\
+  This CMake file is meant to be executed using 'scikit-build-core'.
+  Running it directly will almost certainly not produce the desired
+  result. If you are a user trying to install this package, use the
+  command below, which will install all necessary build dependencies,
+  compile the package in an isolated environment, and then install it.
+  =====================================================================
+   $ pip install .
+  =====================================================================
+  If you are a software developer, and this is your own package, then
+  it is usually much more efficient to install the build dependencies
+  in your environment once and use the following command that avoids
+  a costly creation of a new virtual environment at every compilation:
+  =====================================================================
+   $ pip install nanobind scikit-build-core[pyproject]
+   $ pip install --no-build-isolation -ve .
+  =====================================================================
+  You may optionally add -Ceditable.rebuild=true to auto-rebuild when
+  the package is imported. Otherwise, you need to rerun the above
+  after editing C++ files.")
+endif()
+
+if (CMAKE_VERSION VERSION_LESS 3.18)
+  set(DEV_MODULE Development)
+else()
+  set(DEV_MODULE Development.Module)
+endif()
+
+set(IS_UNIX ${CMAKE_SYSTEM_NAME} STREQUAL "Linux" OR ${CMAKE_SYSTEM_NAME} STREQUAL "Darwin")
+set(IS_WINDOWS ${CMAKE_SYSTEM_NAME} STREQUAL "Windows")
+
+find_package(Python 3.9 COMPONENTS Interpreter ${DEV_MODULE})
+
+# Import nanobind through CMake's find_package mechanism
+find_package(nanobind CONFIG REQUIRED)
+
+
+if (NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
+  set(CMAKE_BUILD_TYPE Release CACHE STRING "Choose the type of build." FORCE)
+  set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS "Debug" "Release" "MinSizeRel" "RelWithDebInfo")
+endif()
+
+# Detect the installed nanobind package and import it into CMake
+execute_process(
+  COMMAND "${Python_EXECUTABLE}" -m nanobind --cmake_dir
+  OUTPUT_STRIP_TRAILING_WHITESPACE OUTPUT_VARIABLE nanobind_ROOT)
+find_package(nanobind CONFIG REQUIRED)
+
+# Allow for some math optimization on unix but not -ffast-math
+# See: https://simonbyrne.github.io/notes/fastmath/#flushing_subnormals_to_zero
+if (IS_UNIX)
+  add_compile_options(-fassociative-math -fno-signaling-nans -fno-trapping-math -fno-signed-zeros -freciprocal-math -fno-math-errno)
+endif()
+
+# Relase build with all optimizations
+if (CMAKE_BUILD_TYPE STREQUAL "Release" AND IS_UNIX)
+  add_compile_options(-O3)
+elseif (CMAKE_BUILD_TYPE STREQUAL "Release" AND IS_WINDOWS)
+  add_compile_options(/Ox)
+endif()
+
+
+# Check the USE_ASAN environment variable, and if set to 1, enable AddressSanitizer
+if (DEFINED ENV{USE_ASAN} AND "$ENV{USE_ASAN}" STREQUAL "1")
+  add_compile_options(-fsanitize=address -fno-omit-frame-pointer)
+  add_link_options(-fsanitize=address)
+endif()
+
+
+nanobind_add_module(
+  voyager_ext
+  # Target the stable ABI for Python 3.12+, which reduces
+  # the number of binary wheels that must be built. This
+  # does nothing on older Python versions
+  NB_STATIC STABLE_ABI LTO FREE_THREADED NOMINSIZE
+  # Sources:
+  src/bindings.cpp
+)
+
+# Install directive for scikit-build-core
+install(TARGETS voyager_ext LIBRARY DESTINATION voyager)

voyager-2.2.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include *.txt tox.ini *.md
+recursive-include tests *.py
+
+graft src
+graft voyager-headers

voyager-2.2.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.1
+Name: voyager
+Version: 2.2.0
+Summary: Easy-to-use, fast, simple multi-platform approximate nearest-neighbor search library.
+Author-Email: Peter Sobot <psobot@spotify.com>
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: C++
+Classifier: Programming Language :: Python
+Classifier: Topic :: Database :: Database Engines/Servers
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Project-URL: Homepage, https://github.com/spotify/voyager
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+![The word Voyager_in blue, with a multicoloured graphic illustrating an orbit to its left.](https://github.com/spotify/voyager/assets/213293/c99cd0e8-cd38-486f-bb61-15f74028ba52)
+
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/spotify/voyager/blob/master/LICENSE)
+[![Documentation](https://img.shields.io/badge/Documentation-on%20github.io-brightgreen)](https://spotify.github.io/voyager)
+[![Supported Platforms](https://img.shields.io/badge/platforms-macOS%20%7C%20Windows%20%7C%20Linux-green)](https://pypi.org/project/voyager)
+[![Apple Silicon support for macOS and Linux (Docker)](https://img.shields.io/badge/Apple%20Silicon-macOS%20and%20Linux-brightgreen)](https://pypi.org/project/voyager)
+[![Test Badge](https://github.com/spotify/voyager/actions/workflows/all.yml/badge.svg)](https://github.com/spotify/voyager/actions/workflows/all.yml)
+<!-- [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/voyager)](https://pypi.org/project/voyager) -->
+<!-- [![PyPI - Wheel](https://img.shields.io/pypi/wheel/voyager)](https://pypi.org/project/voyager) -->
+<!-- [![PyPI - Downloads](https://img.shields.io/pypi/dm/voyager)](https://pypistats.org/packages/voyager) -->
+<!-- [![GitHub Repo stars](https://img.shields.io/github/stars/spotify/voyager?style=social)](https://github.com/spotify/voyager/stargazers) -->
+
+**_Voyager_** is a library for performing fast approximate nearest-neighbor searches on an in-memory collection of vectors.
+
+Voyager features bindings to both Python and Java, with feature parity and index compatibility between both languages. It uses the HNSW algorithm, based on [the open-source `hnswlib` package](https://github.com/nmslib/hnswlib), with numerous features added for convenience and speed. Voyager is used extensively in production at Spotify, and is queried hundreds of millions of times per day to power numerous user-facing features.
+
+Think of Voyager like [Sparkey](https://github.com/spotify/sparkey), but for vector/embedding data; or like [Annoy](https://github.com/spotify/annoy), but with [much higher recall](http://ann-benchmarks.com/). It got its name because it searches through (embedding) space(s), much like [the Voyager interstellar probes](https://en.wikipedia.org/wiki/Voyager_program) launched by NASA in 1977.
+
+[![Python Documentation](https://img.shields.io/badge/Python%20Documentation-on%20github.io-brightgreen)](https://spotify.github.io/voyager/python)
+[![Java Documentation](https://img.shields.io/badge/Java%20Documentation-on%20github.io-brightgreen)](https://spotify.github.io/voyager/java)
+
+### Installation
+
+#### Python
+
+```shell
+pip install voyager
+```
+
+#### Java
+
+Add the following artifact to your `pom.xml`:
+```xml
+<dependency>
+  <groupId>com.spotify</groupId>
+  <artifactId>voyager</artifactId>
+  <version>2.2.0</version>
+</dependency>
+```
+You can find the latest version on [Voyager's Releases page](https://github.com/spotify/voyager/releases).
+
+#### Scala
+
+Add the following artifact to your `build.sbt`:
+```sbt
+"com.spotify" % "voyager" % "2.2.0"
+```
+You can find the latest version on [Voyager's Releases page](https://github.com/spotify/voyager/releases).
+
+
+### Compatibility
+
+| OS        | Language | Version | x86_64 (Intel) | arm64 (ARM) |
+|-----------|----------|---------|---------| --------|
+| Linux     | Python   | 3.9     | ✅       | ✅       |
+| Linux     | Python   | 3.10    | ✅       | ✅       |
+| Linux     | Python   | 3.11    | ✅       | ✅       |
+| Linux     | Python   | 3.12    | ✅       | ✅       |
+| Linux     | Python   | 3.13    | ✅       | ✅       |
+| Linux     | Java     | 8-16+   | ✅       | ✅      |
+| macOS     | Python   | 3.9     | ✅       | ✅       |
+| macOS     | Python   | 3.10    | ✅       | ✅       |
+| macOS     | Python   | 3.11    | ✅       | ✅       |
+| macOS     | Python   | 3.12    | ✅       | ✅       |
+| macOS     | Python   | 3.13    | ✅       | ✅       |
+| macOS     | Java     | 8-16+   | ✅       | ✅       |
+| Windows   | Python   | 3.9     | ✅       | ❌       |
+| Windows   | Python   | 3.10    | ✅       | ❌       |
+| Windows   | Python   | 3.11    | ✅       | ❌       |
+| Windows   | Python   | 3.12    | ✅       | ❌       |
+| Windows   | Python   | 3.13    | ✅       | ❌       |
+| Windows   | Java     | 8-16+   | ✅       | ❌       |
+
+
+## Contributing
+
+Contributions to `voyager` are welcomed!
+See [CONTRIBUTING.md](https://github.com/spotify/voyager/blob/master/CONTRIBUTING.md) for details.
+
+
+### License
+Voyager is copyright 2022-2024 Spotify AB.
+
+Voyager is licensed under the [Apache 2 License]([https://www.gnu.org/licenses/gpl-3.0.en.html](https://www.apache.org/licenses/LICENSE-2.0)).

voyager-2.2.0/README.md

@@ -0,0 +1,84 @@
+![The word Voyager_in blue, with a multicoloured graphic illustrating an orbit to its left.](https://github.com/spotify/voyager/assets/213293/c99cd0e8-cd38-486f-bb61-15f74028ba52)
+
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/spotify/voyager/blob/master/LICENSE)
+[![Documentation](https://img.shields.io/badge/Documentation-on%20github.io-brightgreen)](https://spotify.github.io/voyager)
+[![Supported Platforms](https://img.shields.io/badge/platforms-macOS%20%7C%20Windows%20%7C%20Linux-green)](https://pypi.org/project/voyager)
+[![Apple Silicon support for macOS and Linux (Docker)](https://img.shields.io/badge/Apple%20Silicon-macOS%20and%20Linux-brightgreen)](https://pypi.org/project/voyager)
+[![Test Badge](https://github.com/spotify/voyager/actions/workflows/all.yml/badge.svg)](https://github.com/spotify/voyager/actions/workflows/all.yml)
+<!-- [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/voyager)](https://pypi.org/project/voyager) -->
+<!-- [![PyPI - Wheel](https://img.shields.io/pypi/wheel/voyager)](https://pypi.org/project/voyager) -->
+<!-- [![PyPI - Downloads](https://img.shields.io/pypi/dm/voyager)](https://pypistats.org/packages/voyager) -->
+<!-- [![GitHub Repo stars](https://img.shields.io/github/stars/spotify/voyager?style=social)](https://github.com/spotify/voyager/stargazers) -->
+
+**_Voyager_** is a library for performing fast approximate nearest-neighbor searches on an in-memory collection of vectors.
+
+Voyager features bindings to both Python and Java, with feature parity and index compatibility between both languages. It uses the HNSW algorithm, based on [the open-source `hnswlib` package](https://github.com/nmslib/hnswlib), with numerous features added for convenience and speed. Voyager is used extensively in production at Spotify, and is queried hundreds of millions of times per day to power numerous user-facing features.
+
+Think of Voyager like [Sparkey](https://github.com/spotify/sparkey), but for vector/embedding data; or like [Annoy](https://github.com/spotify/annoy), but with [much higher recall](http://ann-benchmarks.com/). It got its name because it searches through (embedding) space(s), much like [the Voyager interstellar probes](https://en.wikipedia.org/wiki/Voyager_program) launched by NASA in 1977.
+
+[![Python Documentation](https://img.shields.io/badge/Python%20Documentation-on%20github.io-brightgreen)](https://spotify.github.io/voyager/python)
+[![Java Documentation](https://img.shields.io/badge/Java%20Documentation-on%20github.io-brightgreen)](https://spotify.github.io/voyager/java)
+
+### Installation
+
+#### Python
+
+```shell
+pip install voyager
+```
+
+#### Java
+
+Add the following artifact to your `pom.xml`:
+```xml
+<dependency>
+  <groupId>com.spotify</groupId>
+  <artifactId>voyager</artifactId>
+  <version>2.2.0</version>
+</dependency>
+```
+You can find the latest version on [Voyager's Releases page](https://github.com/spotify/voyager/releases).
+
+#### Scala
+
+Add the following artifact to your `build.sbt`:
+```sbt
+"com.spotify" % "voyager" % "2.2.0"
+```
+You can find the latest version on [Voyager's Releases page](https://github.com/spotify/voyager/releases).
+
+
+### Compatibility
+
+| OS        | Language | Version | x86_64 (Intel) | arm64 (ARM) |
+|-----------|----------|---------|---------| --------|
+| Linux     | Python   | 3.9     | ✅       | ✅       |
+| Linux     | Python   | 3.10    | ✅       | ✅       |
+| Linux     | Python   | 3.11    | ✅       | ✅       |
+| Linux     | Python   | 3.12    | ✅       | ✅       |
+| Linux     | Python   | 3.13    | ✅       | ✅       |
+| Linux     | Java     | 8-16+   | ✅       | ✅      |
+| macOS     | Python   | 3.9     | ✅       | ✅       |
+| macOS     | Python   | 3.10    | ✅       | ✅       |
+| macOS     | Python   | 3.11    | ✅       | ✅       |
+| macOS     | Python   | 3.12    | ✅       | ✅       |
+| macOS     | Python   | 3.13    | ✅       | ✅       |
+| macOS     | Java     | 8-16+   | ✅       | ✅       |
+| Windows   | Python   | 3.9     | ✅       | ❌       |
+| Windows   | Python   | 3.10    | ✅       | ❌       |
+| Windows   | Python   | 3.11    | ✅       | ❌       |
+| Windows   | Python   | 3.12    | ✅       | ❌       |
+| Windows   | Python   | 3.13    | ✅       | ❌       |
+| Windows   | Java     | 8-16+   | ✅       | ❌       |
+
+
+## Contributing
+
+Contributions to `voyager` are welcomed!
+See [CONTRIBUTING.md](https://github.com/spotify/voyager/blob/master/CONTRIBUTING.md) for details.
+
+
+### License
+Voyager is copyright 2022-2024 Spotify AB.
+
+Voyager is licensed under the [Apache 2 License]([https://www.gnu.org/licenses/gpl-3.0.en.html](https://www.apache.org/licenses/LICENSE-2.0)).

voyager-2.2.0/__init__.py

@@ -0,0 +1,15 @@
+#! /usr/bin/env python
+#
+# Copyright 2022-2023 Spotify AB
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

voyager-2.2.0/dev-requirements.txt

@@ -0,0 +1,15 @@
+-r test-requirements.txt
+# NumPy 2.0 is the last release series supporting Python 3.9.
+numpy==2.0.2; python_version < "3.10"
+numpy==2.2.6; python_version >= "3.10"
+ruff==0.16.1
+psutil
+mypy
+asv==0.6.3
+# Needed for sphinx documentation
+sphinx
+sphinxext-opengraph
+sphinx-copybutton
+m2r2
+furo
+# end sphinx reqs

voyager-2.2.0/docs/source/conf.py

@@ -0,0 +1,127 @@
+#! /usr/bin/env python
+#
+# Copyright 2022-2023 Spotify AB
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+
+# -- Project information -----------------------------------------------------
+
+import datetime
+from importlib.metadata import version as package_version
+
+project = "Voyager"
+copyright = f"2022-{datetime.date.today().year}, Spotify AB"
+author = "Peter Sobot"
+
+# The full version, including alpha/beta/rc tags
+release = package_version("voyager")
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.duration",
+    "sphinx.ext.doctest",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.napoleon",
+    "sphinx_copybutton",
+    "sphinxext.opengraph",
+    "m2r2",
+]
+
+autosummary_generate = True
+autodoc_docstring_signature = True
+autodoc_member_order = "bysource"
+autodoc_default_options = {
+    "autosummary": True,
+}
+autodoc_inherit_docstrings = False
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = ["_build"]
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = "furo"
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ["_static"]
+
+html_title = f"{project} {release} Python Documentation"
+html_favicon = "_static/favicon.ico"
+html_logo = "voyager-outline-color.png"
+html_baseurl = "voyager/python/"
+
+octocat_points = (
+    "M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38"
+    " 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-."
+    "09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01"
+    " 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95"
+    " 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0"
+    " 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0"
+    " 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013"
+    " 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8z"
+)
+html_theme_options = {
+    "footer_icons": [
+        {
+            "name": "GitHub",
+            "url": "https://github.com/spotify/voyager",
+            "html": f"""
+                <svg stroke="currentColor" fill="currentColor"
+                     stroke-width="0" viewBox="0 0 16 16">
+                    <path fill-rule="evenodd" d="{octocat_points}"></path>
+                </svg>
+            """,
+            "class": "",
+        },
+    ],
+}
+
+ogp_site_url = "https://spotify.github.io/voyager/python/"
+ogp_image = "https://github.com/spotify/voyager/assets/213293/190c07bf-bf43-43d3-a46b-ed71232bbcdd"
+ogp_image_alt = "🛰️ Documentation for Voyager: A nearest-neighbor search library."
+ogp_site_name = html_title

voyager-2.2.0/docs/source/index.rst

@@ -0,0 +1,40 @@
+:og:title: Voyager Documentation
+:og:description: 🛰️ Documentation for Voyager: A nearest-neighbor search library.
+
+.. # define a hard line break for HTML
+.. |br| raw:: html
+
+   <br />
+
+|br|
+
+.. image:: voyager-feature.png
+  :width: 700
+  :alt: The word "Voyager" in white on a black background.
+
+**Voyager** is a library for performing fast approximate nearest-neighbor searches on an in-memory collection of vectors.
+
+Voyager features bindings to both Python and Java, with feature parity and index compatibility between both languages.
+It uses the HNSW algorithm, based on `the open-source hnswlib package <https://github.com/nmslib/hnswlib>`_,
+with numerous features added for convenience and speed. Voyager is used extensively in production at Spotify,
+and is queried hundreds of millions of times per day to power numerous user-facing features.
+
+Think of Voyager like `Sparkey <https://github.com/spotify/sparkey>`_, but for vector/embedding data;
+or like `Annoy <https://github.com/spotify/annoy>`_, but with `much higher recall <https://ann-benchmarks.com>`_.
+It got its name because it searches through (embedding) space(s), much like
+`the Voyager interstellar probes <https://en.wikipedia.org/wiki/Voyager_program>`_ launched by NASA in 1977.
+
+Python compatibility
+--------------------
+
+Voyager 2.2.0 requires Python 3.9 or newer. Python 3.8 is no longer supported.
+
+
+.. toctree::
+   :maxdepth: 1
+
+   Python API Reference <reference>
+
+.. toctree::
+   Java Documentation </voyager/java#http://>
+   GitHub Repo <http://github.com/spotify/voyager>

voyager-2.2.0/docs/source/reference.rst

@@ -0,0 +1,47 @@
+The ``voyager`` Python API
+==========================
+
+This module provides classes and functions for creating indices of vector data.
+
+A quick example on how to get started::
+
+   import numpy as np
+   from voyager import Index, Space
+
+   # Create an empty Index object that can store vectors:
+   index = Index(Space.Euclidean, num_dimensions=5)
+   id_a = index.add_item([1, 2, 3, 4, 5])
+   id_b = index.add_item([6, 7, 8, 9, 10])
+
+   print(id_a)  # => 0
+   print(id_b)  # => 1
+
+   # Find the two closest elements:
+   neighbors, distances = index.query([1, 2, 3, 4, 5], k=2) 
+   print(neighbors)  # => [0, 1]
+   print(distances)  # => [0.0, 125.0]
+
+   # Save the index to disk to reload later (or in Java!)
+   index.save("output_file.voy")
+
+
+.. autoclass:: voyager.Index
+   :members:
+   :inherited-members:
+   :special-members: __contains__, __len__
+
+Enums
+-----
+.. autoclass:: voyager.Space
+   :members:
+   :inherited-members:
+
+.. autoclass:: voyager.StorageDataType
+   :members:
+   :inherited-members:
+
+Utilities
+---------
+.. autoclass:: voyager.LabelSetView
+   :members:
+   :inherited-members:

voyager-2.2.0/py.typed

@@ -0,0 +1 @@
+

voyager-2.2.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["scikit-build-core >=0.4.3", "nanobind >=1.3.2"]
+build-backend = "scikit_build_core.build"
+
+[project]
+name = "voyager"
+version = "2.2.0"
+description = "Easy-to-use, fast, simple multi-platform approximate nearest-neighbor search library."
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [
+    { name = "Peter Sobot", email = "psobot@spotify.com" },
+]
+classifiers = [
+         "Development Status :: 5 - Production/Stable",
+         "License :: OSI Approved :: Apache Software License",
+         "Operating System :: MacOS",
+         "Operating System :: Microsoft :: Windows",
+         "Operating System :: POSIX :: Linux",
+         "Programming Language :: C++",
+         "Programming Language :: Python",
+         "Topic :: Database :: Database Engines/Servers",
+         "Programming Language :: Python :: 3.9",
+         "Programming Language :: Python :: 3.10",
+         "Programming Language :: Python :: 3.11",
+         "Programming Language :: Python :: 3.12",
+]
+# Optional: runtime dependency specification
+# dependencies = [ "cryptography >=41.0" ]
+
+[project.urls]
+Homepage = "https://github.com/spotify/voyager"
+
+[tool.scikit-build]
+# Protect the configuration against future changes in scikit-build-core
+minimum-version = "0.4"
+
+# Setuptools-style build caching in a local directory
+build-dir = "build/{wheel_tag}"
+
+# Build stable ABI wheels for CPython 3.12+
+wheel.py-api = "cp312"
+
+[tool.ruff]
+line-length = 120
+
+# Needed for full C++17 support on macOS
+[tool.cibuildwheel.macos.environment]
+MACOSX_DEPLOYMENT_TARGET = "10.14"