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	【fix】修改测试用例，跑通ut流水线 Co-authored-by: qanly97<maqianli20@h-partners.com>	6 天前
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	Keep NPU Docker build scripts	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	Add self-contained NPU Dockerfiles	2 天前
.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: 补充 Flat 索引 NPU 接口文档 (#32) Co-authored-by: longcat_chen<longcat_eason@139.com>	8 天前

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 加速功能

本项目通过自定义算子加速向量检索的核心计算。算子清单及构建、部署、测试说明详见 NPU 自定义算子模块。

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

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

🚀 快速入门

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

📦 安装指南

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

📘 使用指南

文档入口

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