搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

nataphong-lab/Open-Source-Face-Recognition-Ultimate

机器学习

面向 Windows 和 Linux 的本地人脸识别 Python SDK,支持人脸检测、关键点与特征提取以及相似度比对。

461
374
Python
创建于 1 天前

项目介绍

这个项目把人脸识别流程封装成 Python 接口:在图片中检测一张或多张人脸,返回人脸框和关键点,提取特征向量,并比较两个特征向量的相似度(0 到 100)。README 称全部处理在本地完成,支持 Windows 和 Linux,可在 CPU 上运行,也支持可选的 GPU 加速。

识别模型以 FacePlugin 的开源模型为基础继续训练。README 给出了与 FacePlugin 在 LFW、CFP-FP、AgeDB-30、CALFW、CPLFW 上的对比表,平均分分别为 98.28 和 83.06;这些是项目方自报的评测数据,不是独立测试结果 评测表。

快速使用

文档给出的流程以 Windows 为主:

  1. 克隆仓库并进入目录:

    git clone https://github.com/nataphong-lab/Open-Source-Face-Recognition-Ultimate.git
    cd Open-Source-Face-Recognition-Ultimate
    
  2. 安装 Python 3.9,并在仓库目录执行仓库自带的初始化脚本:

    winget install --id Python.Python.3.9 -e --source winget
    powershell -Ep Bypass ./install.ps1
    
  3. 创建并激活 Conda 环境,安装依赖后启动:

    conda create -n facesdk python=3.9 -y
    conda activate facesdk
    pip install -r requirements.txt
    python run.py
    

作为库使用时,导入 FaceRecognition,调用 GetImageInfo(image_path, faceMaxCount=10),从返回的每张人脸中读取 bbox、landmarks 和 embedding。比较两张人脸时,各自提取一个特征向量,交给 get_similarity;README 以 75 作为同一人的示例阈值,并说明实际阈值需要结合自己的数据和使用条件验证 使用示例。

README 没有说明 install.ps1 具体做什么、如何准备环境,因此仅凭现有资料无法复现这一步 安装步骤。

使用约束

  • 需要 Python 3.9 或更高版本;推荐使用 Anaconda 或 Miniconda,文档流程基于 Conda。
  • 支持 JPG、PNG、BMP 和 TIFF 图片;接口接收文件路径和最大检测人脸数。
  • 仓库未声明许可证,分发和商用条款不明确。
  • 评测数字来自项目方自己的对比,README 没有说明测试协议、预处理方式或评测代码。
  • run.py 被列为启动入口,但 README 没有描述启动后的界面或输出。

HotRepo 点评

该项目在 2026-11-19 进入 HotRepo 新项目榜,当日约 13 小时内记录到 110 个 Star,同一窗口新增 82 个 Fork。对一个文档主要展示 Python 人脸识别 API、安装流程又包含 PowerShell 脚本的仓库来说,这个开局速度较快。HotRepo 数据中没有该仓库的 GitHub 全部语言日榜名次,因此这份记录只能说明当天的可见度,不能说明它在全站日榜上的位置或增长能否持续。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. inclusionAI/IDM提供基于内在分布匹配的 1~2 步文生图推理代码与实验方法,面向研究人员。Python161
  2. speridlabs/idol-sdk把单张物体图片转成标准 3D Gaussian splat,可在消费级 GPU 上运行,适合 3D 创作者、研究者和开发者。Python385
  3. ubc-vision/solv3r预训练的多视图 3D 重建模型,可从图片或视频序列求解相机位姿与点图。Python158
  4. pookjw/HermesEnabler通过侧载应用并修改设备配置,在 Apple Watch 上启用 Hermès 表盘。Objective-C1,316
  5. isl-org/Open3D用 C++ 和 Python 处理点云、网格、配准、重建与三维可视化的通用库。C++14,124