Apache Paimon Vector Index: pure Rust IVF-PQ for data lake vector search.

Clone this repo:
  1. 17b1941 feat: add range search across language bindings (#110) by Junrui Lee · 2 days ago main
  2. 0e25175 feat: add cosine and inner-product range search for IVF indexes (#108) by Junrui Lee · 3 days ago
  3. 4de0737 docs: publish vector index 0.5.0 release notes (#109) by jerry · 4 days ago
  4. a36bb97 feat: add IVF-PQ L2 distance range search (#107) by Junrui Lee · 4 days ago
  5. 643b4ed feat: add IVF-SQ L2 distance range search (#106) by Junrui Lee · 7 days ago

Apache Paimon Vector Index   Build Status

Apache Paimon Vector Index is a pure Rust vector indexing library designed for Apache Paimon and data lake storage such as S3, HDFS, and OSS. Its seek-based readers load only the index pages needed by each query.

The library supports IVF-FLAT, IVF-SQ, IVF-PQ, IVF-RQ, and DiskANN through shared Rust, C, C++, Java/JNI, and Python APIs. IVF-RQ stores deterministic rotated residuals as 1–8 bit planes (4 by default), uses a bounded sign-plane coarse pass before full refinement, and exposes the persisted width as rq_bits metadata. DiskANN combines a Vamana graph, resident PQ codes, paged adjacency/raw vectors, and F16 or F32 reranking for indexes queried from local SSD or object storage. Its parallel builder uses contiguous fixed-capacity adjacency, adaptive dense/sparse visited state, heap frontiers, and reusable prune scratch; query-local adjacency retention is bounded and the shared cold cache is sharded for concurrent hits.

Documentation

GitHub shows committed HTML files as source. To view the styled documentation, clone the repository and serve docs/ from the repository root:

python3 -m http.server --directory docs 8000

Then open http://localhost:8000/. All documentation assets are local, so no separate build step is required.

Source Layout

Public implementations live in core, ffi, include, jni, java, and python. See the development guide for responsibilities and verification commands.

Contributing

Getting Help

Submit an issue or ask a question in GitHub Discussions.

License

Licensed under the Apache License, Version 2.0.