InsightFace 1.0GUI人脸识别评测换脸

InsightFace 1.0 指南：本地人脸识别、桌面 GUI 与企业评测

安装更轻量的 InsightFace 1.0 package，启动跨平台 Evaluation Studio，并用本地流程完成识别、相册聚类、企业数据集评测、换脸试验，以及模型授权和隐私边界检查。

2026-05-23•11 分钟阅读

InsightFace Evaluation Studio 总览，包含人脸识别、相册管理、企业评测、换脸、模型和授权界面 — InsightFace 1.0 package 中的 InsightFace Evaluation Studio。

你将完成什么

InsightFace 1.0 保留熟悉的 Python FaceAnalysis API，同时让基础安装更轻量。可选的 face3d Cython/C++ 扩展不再默认构建，因此多数只需要检测、对齐和识别的用户，不再需要在默认安装路径上准备本地编译工具链。

这个版本还带来了 InsightFace Evaluation Studio：通过 package extra 安装的跨平台 PySide6 桌面 GUI。它为开发者、研究者和企业评估团队提供本地工作区，可用于人脸识别、相册聚类、数据集评测和换脸试验。

1.0版本同时也移除了部分不必要的依赖库.

开始之前

Python 3.9+ 和 virtual environment。只有在可以接受桌面依赖的机器上才安装 GUI extra。
本地模型缓存，或把模型 pack 下载到 InsightFace 模型目录的权限。
用于目标流程的代表性图片，或按身份文件夹组织的数据集。
在处理生物特征数据或进行换脸试验前，先明确同意、保留期限和部署授权策略。

1. InsightFace 1.0 有哪些变化

基础 Python package 现在更容易安装，因为可选 face3d 扩展不再默认编译。这并不表示仓库中所有 C++ 代码都被移除了；它表示只需要检测、对齐和识别的用户，不必在默认安装时承担编译成本。

新的 GUI demo 作为可选 extra 发布，而不是独立桌面安装包。需要桌面体验时安装 insightface[gui]，然后在 macOS、Windows 或 Linux 上从命令行启动。

Face Recognition mode：一个 query image 加一个或多个 gallery image，可做 1:1 验证或本地 1:N 搜索。
Album Management mode：导入本地文件夹、提取特征、用 DBSCAN 聚类人脸，并复核人物分组。
Enterprise Evaluation mode：基于 identity folders 在本地运行 1:1 和 1:N 评测，包含数据校验、指标和报告输出。
Face Swap mode：配置兼容换脸模型后，使用 source 加 target 的图片或视频试验流程。
Models、License、Settings dialogs：控制运行时 provider、模型根目录、手动下载、授权状态、主题和语言。

2. 安装更轻量的 Python package

Python 服务、notebook 和命令行实验应从 base package 开始。它保留 FaceAnalysis API 和默认模型行为，但不会安装完整桌面栈。

最小 smoke test 应创建 FaceAnalysis app，在 CPU 上 prepare；如果默认 buffalo_l 模型已经位于 InsightFace cache 中，就会加载该模型，并返回人脸框、关键点和 512 维识别 embedding。默认使用 SCRFD 检测，默认检测尺寸为 Auto：128x128 加 640x640。

安装 base package

pip install insightface

最小 FaceAnalysis smoke test

import insightface
from insightface.app import FaceAnalysis
from insightface.data import get_image

app = FaceAnalysis(providers=["CPUExecutionProvider"])
app.prepare(ctx_id=-1)
faces = app.get(get_image("t1"))
print(len(faces), faces[0].embedding.shape)

3. 安装并启动 GUI demo

只有需要桌面 Evaluation Studio 时才安装 GUI 依赖。GUI workspace 默认为 ~/.insightface/gui，本地设置、索引、缩略图、生成报告和保存结果都可以与项目代码分开。

即使缺少模型，GUI 也应该能够打开。使用 Models dialog 刷新模型 URL、手动下载 model packs、选择 ONNX Runtime providers，或将 app 指向自定义模型目录。

GUI 不会自动下载模型。
图片、视频、embedding、缩略图和报告默认在本地处理，不会自动上传。
本指南中的截图为英文界面，但 GUI app 支持多语言；可以在 Settings 中切换界面语言。
建议使用 virtual environment，避免 PySide6 和 GUI-only 依赖影响服务端部署。

安装 GUI extra

pip install "insightface[gui]"
insightface-gui

等价启动命令

insightface-eval-studio
insightface-desktop
python -m insightface.gui

4. 使用 Face Recognition mode

InsightFace Face Recognition mode，包含 Query 和 Gallery 上传区域 — Face Recognition mode 支持快速 1:1 比对和本地 1:N 搜索。

当你想快速测试身份匹配而不想写代码时，使用 Face Recognition mode。上传一个 query image，再添加一个 gallery image 做 1:1 比对，或添加多个 gallery images / folders 做本地 1:N 搜索。

Gallery embeddings 会缓存在内存中，直到 gallery 发生变化。图片中有多张脸时，请为测试选择 multi-face handling policy；实用默认值是使用最大且居中的人脸。识别阈值应保持可见、可配置，因为生产阈值需要在你自己的验证数据上确定。

5. 用 Album Management 管理本地照片

InsightFace Album Management mode，用于本地照片文件夹聚类 — Album Management 会从选定的本地文件夹中聚类人脸。

Album Management 是一个本地智能照片整理流程。添加一个或多个本地相册目录后，运行 Import / Refresh 重新扫描文件夹，并为新图片提取特征。Rebuild All 会清除已索引特征并从头重建聚类。

聚类流程使用 DBSCAN 和 cosine similarity threshold。人脸缩略图和照片缩略图会以压缩 WebP blobs 的形式存入本地 SQLite；选择某个 cluster 后，可以查看该人物分组对应的原始照片。

6. 在本地评测企业数据集

InsightFace Enterprise Evaluation mode，用于 1:1 与 1:N 模型评测 — Enterprise Evaluation mode 帮助团队在部署决策前完成本地验证。

Enterprise Evaluation mode 帮助团队在部署或采购决策前，用自己的数据测试 InsightFace。它支持基于 identity folders 的 1:1 与 1:N 评测；当数据集还没有预先划分时，Auto Split 可以从每个 identity folder 中生成 gallery/probe split。

运行指标前，先用 dataset validation 检查目录布局问题和关键人脸有效性问题。报告应包含 model/runtime、dataset summary、thresholds、best-threshold accuracy、Top-1、样本量允许时的 TAR@FAR、errors、latency、license status、responsible-use notes 和 recommended next steps。

需要可控 open-set 1:N 评测时，使用明确的 gallery、probe 和 unknown folders。
早期探索可以使用 Auto Split；正式比较模型前，应冻结专门的 test split。
报告在本地生成，不会自动上传。

包含明确 gallery 与 probe folders 的 1:N 数据集

dataset_1n/
  gallery/
    0001__Alice/
      enroll_001.jpg
      enroll_002.jpg
    0002__Bob/
      enroll_001.jpg
  probe/
    0001__Alice/
      test_001.jpg
    0002__Bob/
      test_001.jpg
  unknown/
    unknown_001.jpg

用于 Auto Split 的 identity folders

dataset/
  identities/
    0001__Alice/
      img001.jpg
      img002.jpg
      img003.jpg
    0002__Bob/
      img001.jpg
      img002.jpg

7. 谨慎试用 Face Swap mode

InsightFace Face Swap mode，包含 Source、Target 和 Result 面板 — 配置兼容模型后，Face Swap mode 会运行 source-and-target 换脸流程。

Face Swap mode 是本地 source 加 target 流程。Target 可以是图片或视频；已配置的 swap model 只会在执行换脸时加载；生成结果保存在本地 workspace。

下载第三方模型后，可以启用可选 GFPGAN 后处理。请把换脸试验当作单独的授权路径处理：在使用 source identities 或发布生成结果前，需要适当的权利、同意和模型许可。

8. 配置模型、设置、授权和隐私边界

InsightFace Model Manager dialog，用于运行时和模型下载配置 — Models dialog 控制 runtime provider、模型根目录、下载和可选换脸资产。

InsightFace License Center dialog，显示代码和模型使用摘要 — License Center 用于区分 code、model 和 commercial usage guidance。

InsightFace Settings dialog，包含主题和语言控制 — Settings 将桌面偏好保存在本地 GUI workspace 中。

使用 Models 选择 runtime model、provider、detection size、swap model、GFPGAN setting、下载位置和 custom model root。评估团队也可以在这里把商业或私有模型 artifact 与公开 model packs 分开管理。

使用 License 复核 code license 与 model license 的区别。模型文件可能拥有不同于 package code 的授权边界，商业部署需要正确的模型授权。InsightFace 1.0.1 移除了 PyPI package metadata license 字段，但 README license guidance 仍是需要阅读的来源。

默认情况下，所有处理都在本地进行。图片、视频、embedding 或报告不会自动上传。用户需要自行负责 consent、privacy、retention，以及适用 biometric regulations 下的合规要求；本指南是实用产品文档，不构成法律建议。

9. 商业部署下一步

如果需要商业模型授权、私有模型评测、SDK/API access、SLA、on-prem delivery 或 custom training，请联系 InsightFace。Evaluation Studio 适合早期技术筛选，但生产授权取决于模型、数据、使用场景和部署合同。

在 license scope 允许的范围内，使用 open-source packs 做实验、原型和部署。
需要在自己的 identity-folder datasets 上比较更强的商业识别模型时，使用 private evaluation。
不要把 GUI 可用性视为模型商业部署许可；模型授权必须单独确认。

需要生产部署支持？

联系 InsightFace，获取模型授权、运行时优化和目标硬件部署支持。

提交企业询盘