fork开源faiss，提供向量检索NPU加速能力。

文件	最后提交记录	最后更新时间
.devcontainer	feat: add devcontainer configuration for Faiss NPU and rename wheel to faiss-ascend Co-authored-by: gcw_npKwvWT2<lanxin9@huawei.com>	13 天前
.gitcode	更新PR模板 Co-authored-by: yihao1234<yihao6@huawei.com>	3 个月前
benchs	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
c_api	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
ci	feat: add devcontainer configuration for Faiss NPU and rename wheel to faiss-ascend Co-authored-by: gcw_npKwvWT2<lanxin9@huawei.com>	13 天前
cmake	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
conda	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
contrib	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
demos	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
faiss	添加 CANN 环境变量初始化命令在快速入门的测试步骤中添加 ascend-toolkit/set_env.sh 以确保测试脚本能正确访问 NPU 资源全量编译和仅仅编译部署ops算子模块	2 天前
misc	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
perf_tests	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
pre-commit	新增gitleaks检测工具 Co-authored-by: yihao1234<yihao6@huawei.com>	2 个月前
tests	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
tutorial	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
.clang-format	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
.dockerignore	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
.gitignore	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
.pre-commit-config.yaml	新增gitleaks检测工具 Co-authored-by: yihao1234<yihao6@huawei.com>	2 个月前
CHANGELOG.md	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
CMakeLists.txt	[add] NPU相关编译适配，SWIG适配 Co-authored-by: 马千里<949120498@qq.com>	3 个月前
CODE_OF_CONDUCT.md	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
CONTRIBUTING.md	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
Doxyfile	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
INSTALL.md	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
LICENSE	【init】使用faissv1.13.2初始化仓库 cherry-pick merge request: 【init】基于faissv1.13.2初始化仓库 576fa7e53ad06cd2de2c4b29ca4e1d1bdb443db0 This cherry-pick merge request !3	5 个月前
README.md	【Docs】中文文档修改，对齐IndexSDK格式 Co-authored-by: qanly97<maqianli20@h-partners.com>	11 天前

Faiss NPU

基于 Meta Faiss 的昇腾 NPU 加速版本

✨ 最新消息

🔹 [2026.5.20]：🚀 基于 Meta Faiss 提供 NPU 加速能力，算法持续实现中

ℹ️ 简介

Faiss NPU 是在 Meta 开源 Faiss（Facebook AI Similarity Search）v1.13.2 基础上深度适配的昇腾 NPU 加速版本，为大规模向量检索提供高性能的硬件加速能力。项目完整保留 Meta Faiss 的功能和 API 接口，并通过 AscendC 自定义算子针对昇腾 NPU 的硬件特性进行优化。更多详情可查看简介。

⚙️ 功能介绍

NPU 加速功能

本项目实现了多个 AscendC 自定义算子，用于加速核心计算：

算子名称	功能描述	文档链接
topk_flat_cpu	Flat 算法 TopK 选择	详细文档
topk_flat_fp32_cpu	Flat 算法 TopK 选择（FP32）	详细文档
topk_ivfpq_l3_cpu	IVFPQ L3 阶段 TopK 归并	详细文档
distance_flat_ip	Flat 内积距离计算	详细文档
distance_flat_l2	Flat L2 距离计算	详细文档
distance_flat_extrema_at_fp32	Flat L2/IP 距离计算（FP32）	详细文档
ascendc_dist_int8_flat_cos	Int8 Flat 余弦距离计算	详细文档
ascendc_dist_int8_flat_l2	Int8 Flat L2 距离计算	详细文档
ascendc_ivfpq_search_distance_ip	IVFPQ IP 距离计算	详细文档
ascendc_ivfpq_subspace_distance	IVFPQ 子空间距离计算	详细文档

NPU 索引/向量变换 API 文档：

类型	功能描述	文档链接
IVFPQ	倒排文件 + 乘积量化索引，结合 IVF 粗量化和 PQ 细量化，支持单卡推理、多卡分片、多卡副本等多种部署模式，可在 NPU 上完成训练与推理	详细文档
OPQ	优化乘积量化预处理，通过训练旋转矩阵减小各子空间方差相关性，提升 IVFPQ 检索精度，旋转矩阵训练与数据变换均在 NPU 上完成，可作为 IndexIVFPQ 的前置变换	详细文档

🚀 快速入门

Faiss NPU 提供了一个简单样例，帮助用户快速体验通过 Faiss NPU 进行检索的流程。详情可参考快速入门。

📦 安装指南

Faiss NPU 依赖 NPU 驱动、固件和 CANN 环境，支持通过源码编译并安装部署。详细安装步骤请参考安装指南。

📘 使用指南

文档入口

文档	说明
简介	了解 Faiss NPU 的项目背景、特点和架构
快速入门	通过样例快速体验 Faiss NPU 检索流程
安装指南	查看环境准备、编译安装和部署说明
FAQ	常见问题解答与使用答疑