Increment to next release, v1.12.0 (#4522)

Summary:
Pull Request resolved: #4522

Prior one: D73595484

Wiki: https://www.internalfb.com/wiki/Vector_Search/Onboarding/Faiss_Contributor/Release/Release_Process/

Reviewed By: junjieqi, subhadeepkaran

Differential Revision: D79863512

fbshipit-source-id: cb2af3990551756344d8dfb8af3f2f94c2f6f928

Author: Michael Norris

CHANGELOG.md

@@ -3,6 +3,129 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [1.12.0] - 2025-08-11
+
+
+Added
+- Adding `Ex` suffix for extended API (#4512)
+- SIMD optimization RaBitQ (#4515)
+- Binary CAGRA with NN Descent (#4445)
+- BinaryHNSWCagra Struct; Allow base_level_only (#4478)
+- Added libgflags-dev to Dockerfile (#4460)
+- try to add nightly conda publish for Faiss classic GPU with CUDA 12.4 (#4442)
+- Add support for IndexIDMap with Cagra fp16 (#4411)
+- Faiss + Cuvs Example Notebook (#4434)
+- Common ancestor to top-k result handlers (#4414)
+- Add rabitq to reverse factory string so telemetry wrapper will log it (#4428)
+- Add option to link cuda statically (#4422)
+- support extra metrics in IVF (#4409)
+- Support decode_vectors (sa_decode but no decode_listnos) in multiple IVF index (#4400)
+- Add workaround to check SVE support when numpy.distutils is not available (#4416)
+- Dsweet/gowers distance (#4371)
+- cuVS Cagra FP16 support (#4384)
+- Add cuVS filter conversion utility (#4378)
+- GpuIndexBinaryCagra - Binary CAGRA index (#4331)
+- Add guarantee_connectivity parameter to GpuIndexCagra (#4388)
+- Add Virtual Destructor to FlatIndex Class (#4381)
+- Adding unit tests for supporting pre-built KNN while using `IndexNSG` (#4368)
+- Pass in "own_invlists" to ivf index constructor (#4353)
+- Add new centroid_id_column to support previous_assignment_table (#4343)
+- Copy IVF Centroids to Host for CPU Quantizer (#4336)
+- Expose IndexBinaryIVF to C API (#4302)
+- Add rabitq bench to source control (#4307)
+
+Changed
+- Remove unused cmath include from IndexPQ.cpp (#4518)
+- Allow Odd Degree Binary CAGRA graph to HNSW conversion (#4516)
+- Remove unused cassert and cmath headers from Index2Layer.cpp (#4514)
+- Remove unused headers from AutoTune.cpp and clone_index.cpp (#4513)
+- Remove unused import header from IndexBinaryHNSW.cpp (#4507)
+- Remove unused import header from IndexBinaryHash.cpp (#4506)
+- Remove unused import header from IndexIDMap.cpp (#4505)
+- Remove unused import header from AutoTune.cpp (#4504)
+- Make GpuIndexCagra reuse existing memory block when converting to CPU index (#4477)
+- Remove unused standard library includes from index_io.h (#4495)
+- Remove unused standard library includes from Index.h (#4494)
+- Remove unused standard library includes from IndexBinary.h (#4493)
+- Remove unused platform_macros.h include from MetricType.h (#4490)
+- fbcode//faiss:faiss (#4462)
+- fbcode//faiss/gpu:faiss (#4463)
+- fbcode//faiss/gpu/test:test_utils (#4464)
+- BW compatibility for read & write with `numeric_type_` in cagra (#4441)
+- Upgrade cuVS version to 25.08 (#4394)
+- Improve naming of the residual_quantizer_encode_steps.cpp file (#4433)
+- Github actions: upgrade windows-2019 to windows-2022 (#4417)
+- Update the dependency for submitit in faiss_bench_fw (#4410)
+- Increase top-k limit on GPU for cuVS (#4325)
+- Let IndexShards Pass down SearchParams (#4387)
+- Change uint8_t* => const uint8_t* in faiss::ZeroCopyIOReader (#4376)
+- Set code_size for more InvertedListScanner implementations (#4365)
+- Improving variable name post codemod changes (#4369)
+- Improve naming due to codemod (#4367)
+- Use packaging.version for correct version parsing (#4330)
+- Update Swig File for CAGRA Params (#4314)
+
+Fixed
+- Fix the warning that numpy.core._multiarray_umath is deprecated and has been renamed to numpy._core._multiarray_umath (#4501)
+- Fix inline code syntax (#4437)
+- Bug fix for faiss_Index_sa_code_size (#4492)
+- Fix CQS signal modernize-use-using in fbcode/faiss/tests [B] [B] (#4483)
+- Fix CQS signal modernize-use-using in fbcode/faiss/tests [B] [A] (#4484)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss/utils [B] [B] (#4479)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss/utils [B] [A] (#4480)
+- Fix CQS signal modernize-use-using in fbcode/faiss/tests [A] (#4476)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss/utils [A] (#4475)
+- Fix ALL nightlies (#4471)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss/invlists (#4467)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss/perf_tests (#4458)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss/tests (#4457)
+- `int8` support for cuVS cagra (#4439)
+- Fix indexes after fp16 change (#4452)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss (#4454)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss/gpu (#4453)
+- Fix CQS signal facebook-unused-include-check in fbcode/faiss (#4451)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss/benchs (#4449)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss/impl (#4447)
+- Revert D78330300 (#4448)
+- Fix CQS signal readability-braces-around-statements in fbcode/faiss/tutorial (#4446)
+- Fix CQS signal facebook-unused-include-check in fbcode/faiss/utils (#4435)
+- Fix CQS signal facebook-unused-include-check in fbcode/faiss/perf_tests (#4443)
+- Fix CQS signal facebook-unused-include-check in fbcode/faiss/impl (#4436)
+- Remove Debug Statement (#4425)
+- Fix invalid long_description in setup.py (#4398)
+- Fix building on mingw (#4420)
+- fix: add avx2 in python if avx512 enabled (#4419)
+- IndexFlat: Reconstruct validate if key < ntotal (#4415)
+- cmake: disable installing external documents under docs/faiss (#4406)
+- Pin openblas 0.3.30 to fix nightly breakage (#4404)
+- Add override to IndexBinaryCagra (#4401)
+- Fix CQS signal facebook-unused-include-check in fbcode/faiss/gpu (#4390)
+- Fix CQS signal facebook-unused-include-check in fbcode/faiss/impl (#4395)
+- Fix unreachable-break issue in faiss/IndexAdditiveQuantizer.cpp +1 (#4391)
+- Fix CQS signal facebook-unused-include-check in fbcode/faiss/utils (#4389)
+- fix IndexIVFFastScan ndis/nlist stat (#4383)
+- fix: update broken links (#4382)
+- Fix incorrect constructor docstring for IndexScalarQuantizer (#4350)
+- Fix CQS signal facebook-unused-include-check in fbcode/faiss/tests (#4375)
+- Fix input param for IndexIVFScalarQuantizer in index_factory (#4358)
+- Fix openMP index bug (#4348)
+- Fix CQS signal. Id] 95408353 -- performance-faster-string-find in fbcode/faiss (#4345)
+- cmake: install missing header `impl/zerocopy_io.h` (#4328)
+- Fix CQS signal. Id] 62183176 -- readability-redundant-string-init in fbcode/faiss/impl (#4332)
+- Fix CQS signal. Id] 57328835 -- performance-unnecessary-value-param in fbcode/faiss/impl (#4329)
+- Fix IndexBinaryIVF::merge_from (#4305)
+- FreeBSD compatibility patch (#4316)
+
+Deprecated
+- Deprecate CUDA 11 from Faiss nightly and releases (#4496)
+- Deprecate CUDA 11 nightly, add 12.4 to build-release, fix cuvs nightly (#4482)
+- Remove cuVS CUDA 11.8 CI (#4444)
+- remove ABS_INNER_PRODUCT metric (#4408)
+- Disable failing test until we support CUDA 12.8 in CI (#4392)
+- Disable flaky ivfflat test_mem_leak
+
+
+
 ## [1.11.0] - 2025-04-24
 
 

CMakeLists.txt

@@ -47,7 +47,7 @@ if(FAISS_ENABLE_CUVS)
 endif()
 
 project(faiss
-  VERSION 1.11.0
+  VERSION 1.12.0
   DESCRIPTION "A library for efficient similarity search and clustering of dense vectors."
   HOMEPAGE_URL "https://github.com/facebookresearch/faiss"
   LANGUAGES ${FAISS_LANGUAGES})

INSTALL.md

@@ -12,13 +12,13 @@ To install the latest stable release:
 
 ``` shell
 # CPU-only version
-$ conda install -c pytorch faiss-cpu=1.11.0
+$ conda install -c pytorch faiss-cpu=1.12.0
 
 # GPU(+CPU) version
-$ conda install -c pytorch -c nvidia faiss-gpu=1.11.0
+$ conda install -c pytorch -c nvidia faiss-gpu=1.12.0
 
 # GPU(+CPU) version with NVIDIA cuVS
-$ conda install -c pytorch -c nvidia -c rapidsai -c conda-forge libnvjitlink faiss-gpu-cuvs=1.11.0
+$ conda install -c pytorch -c nvidia -c rapidsai -c conda-forge libnvjitlink faiss-gpu-cuvs=1.12.0
 
 # GPU(+CPU) version using AMD ROCm not yet available
 ```
@@ -34,7 +34,7 @@ Nightly pre-release packages can be installed as follows:
 $ conda install -c pytorch/label/nightly faiss-cpu
 
 # GPU(+CPU) version
-$ conda install -c pytorch/label/nightly -c nvidia faiss-gpu=1.11.0
+$ conda install -c pytorch/label/nightly -c nvidia faiss-gpu=1.12.0
 
 # GPU(+CPU) version with NVIDIA cuVS (package built with CUDA 12.4)
 conda install -c pytorch -c rapidsai -c rapidsai-nightly -c conda-forge -c nvidia pytorch/label/nightly::faiss-gpu-cuvs 'cuda-version>=12.0,<=12.5'

faiss/Index.h

@@ -17,7 +17,7 @@
 #include <sstream>
 
 #define FAISS_VERSION_MAJOR 1
-#define FAISS_VERSION_MINOR 11
+#define FAISS_VERSION_MINOR 12
 #define FAISS_VERSION_PATCH 0
 
 // Macro to combine the version components into a single string

faiss/python/setup.py

@@ -105,7 +105,7 @@
 """
 setup(
     name="faiss",
-    version="1.11.0",
+    version="1.12.0",
     description="A library for efficient similarity search and clustering of dense vectors",
     long_description=long_description,
     long_description_content_type="text/plain",