base on 🛰️ An approximate nearest-neighbor search library for Python and Java with a focus on ease of use, simplicity, and deployability.  [](https://github.com/spotify/voyager/blob/master/LICENSE) [](https://spotify.github.io/voyager) [](https://pypi.org/project/voyager) [](https://pypi.org/project/voyager) [](https://github.com/spotify/voyager/actions/workflows/all.yml) <!-- [](https://pypi.org/project/voyager) --> <!-- [](https://pypi.org/project/voyager) --> <!-- [](https://pypistats.org/packages/voyager) --> <!-- [](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. [](https://spotify.github.io/voyager/python) [](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.1.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.1.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)). ", Assign "at most 3 tags" to the expected json: {"id":"5277","tags":[]} "only from the tags list I provide: []" returns me the "expected json"