🆕 Find the k-nearest neighbors (k-NN) for your vector data https://opensearch.org/docs/latest/search-plugins/knn/index/
Find a file
ShawnQiang 159e40de50
Fix KNN build and run due to Lucene upgrade 10.4.0 (#3135)
Co-authored-by: Navneet Verma <navneev@amazon.com>
2026-03-05 16:48:51 -08:00
.github Fix KNN build and run due to Lucene upgrade 10.4.0 (#3135) 2026-03-05 16:48:51 -08:00
.idea Add simple IntelliJ debugger config (#2287) 2024-11-25 23:19:54 -08:00
benchmarks Remove benchmarks folder from k-NN repo (#2127) 2024-09-19 09:33:09 -07:00
build-tools Onboard to s3 snapshots (#2943) 2025-10-16 15:55:18 -04:00
buildSrc Switch checkstyle to spotless (#297) 2022-02-18 09:41:38 -08:00
gradle Gradle 9.2.0 and GitHub Actions JDK 25 Upgrade (#2984) 2025-11-24 14:21:25 -08:00
jni [Enhancement] Make Merge in nativeEngine can Abort (#2529) 2026-02-09 15:55:15 -08:00
qa Add IT and bwc test with indices containing both vector and non-vector docs (#3064) 2026-01-28 14:27:19 -08:00
release-notes Include opensearchknn_simd in build configurations (#3025) 2025-12-13 19:46:42 -08:00
remote-index-build-client Onboard to s3 snapshots (#2943) 2025-10-16 15:55:18 -04:00
scripts Include opensearchknn_simd in build configurations (#3025) 2025-12-13 19:46:42 -08:00
src Fix KNN build and run due to Lucene upgrade 10.4.0 (#3135) 2026-03-05 16:48:51 -08:00
.codecov.yml Fix KNN build and run due to Lucene upgrade 10.4.0 (#3135) 2026-03-05 16:48:51 -08:00
.gitignore Clean JNI artifacts with ./gradlew clean (#2516) 2025-02-11 00:21:00 -06:00
.gitmodules Add faiss support in jni (#28) 2021-10-22 14:47:59 -07:00
.whitesource Add .whitesource configuration file (#249) 2022-01-06 11:55:57 -08:00
ADMINS.md Add ADMINS.md 2021-06-23 15:48:16 -07:00
build.gradle Fix KNN build and run due to Lucene upgrade 10.4.0 (#3135) 2026-03-05 16:48:51 -08:00
CHANGELOG.md Fix KNN build and run due to Lucene upgrade 10.4.0 (#3135) 2026-03-05 16:48:51 -08:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT 2021-04-16 09:14:53 -07:00
CONTRIBUTING.md Add CHANGELOG (#800) 2023-03-13 15:35:50 -07:00
DEVELOPER_GUIDE.md [docs] add mac specific cmake instructions (#3003) 2025-12-12 12:11:59 -08:00
gradle.properties Bump default bwc version to 1.3.4 (#477) 2022-07-28 16:12:13 -07:00
GRADLE_GRAPH.md Added new gradle task validateLibraryUsage so that System.loadLibrary cannot be run outside of KNNLibraryLoader (#3033) 2025-12-18 13:29:55 -08:00
gradlew Gradle 9.2.0 and GitHub Actions JDK 25 Upgrade (#2984) 2025-11-24 14:21:25 -08:00
gradlew.bat Gradle 9.2.0 and GitHub Actions JDK 25 Upgrade (#2984) 2025-11-24 14:21:25 -08:00
LICENSE.txt Add windows support (#583) (#599) 2022-10-28 15:59:52 -05:00
lombok.config Adding lombok support (#393) 2022-05-11 17:15:32 -07:00
MAINTAINERS.md Adding Vikasht34 as maintainer for k-NN repo (#2482) 2025-02-03 11:17:14 -08:00
NOTICE.txt Update license headers (#194) 2021-11-09 18:26:35 -06:00
README.md Update README.md (#2821) 2025-08-04 13:10:00 -04:00
RELEASING.md Refactor BWC framework into sub-projects (#362) 2022-04-18 11:11:59 -05:00
RFC.md Fix invalid url 2021-09-10 14:53:18 -07:00
SECURITY.md Updating security reachout email (#1700) 2024-05-15 09:23:06 -07:00
settings.gradle [Remote Index Client] Move remote client to a separate module (#2603) 2025-03-17 12:52:48 -07:00
TRIAGING.md Update TRIAGING.md (#2749) 2025-06-12 18:43:33 -04:00

Build and Test k-NN codecov Documentation Chat PRs welcome!

OpenSearch k-NN

Welcome!

OpenSearch k-NN enables you to run the nearest neighbor search on billions of documents across thousands of dimensions with the same ease as running any regular OpenSearch query. You can use aggregations and filter clauses to further refine your similarity search operations. k-NN similarity search powers use cases such as product recommendations, fraud detection, image and video search, related document search, and more.

Project Resources

Credits and Acknowledgments

This project uses two similarity search libraries to perform Approximate Nearest Neighbor Search: the Apache 2.0-licensed Non-Metric Space Library and the MIT licensed Faiss library. Thank you to all who have contributed to those projects including Bilegsaikhan Naidan, Leonid Boytsov, Yury Malkov and David Novak for nmslib and Hervé Jégou, Matthijs Douze, Jeff Johnson and Lucas Hosseini for Faiss.

Code of Conduct

This project has adopted the Amazon Open Source Code of Conduct. For more information see the Code of Conduct FAQ, or contact opensource-codeofconduct@amazon.com with any additional questions or comments.

License

This project is licensed under the Apache v2.0 License.

Copyright OpenSearch Contributors. See NOTICE for details.