如何用 InsightFace GUI 对本地照片相册做人物聚类并调整相似度阈值【免费下载链接】insightfaceState-of-the-art 2D and 3D Face Analysis Project项目地址: https://gitcode.com/GitHub_Trending/in/insightface手头有一批本地照片比如一个家庭相册目录想按同一个人自动分组并能控制分组的松紧。InsightFace 1.0.1 的桌面 GUIInsightFace Evaluation Studio在Album Management Album页面提供了这个能力导入本地相册文件夹检测人脸并保存特征然后用 DBSCAN 对所有已索引的人脸做聚类页面直接暴露一个余弦相似度阈值默认0.48数值越高分组越严格。整个流程在本地完成处理结果保存在本地 SQLite 数据库下次启动会自动恢复。安装与启动 GUI在仓库的python-package目录下带 GUI 附加依赖安装cd python-package pip install -e .[gui] insightface-gui从 PyPI 安装的等价命令是pip install insightface[gui] insightface-guiinsightface-gui也有别名insightface-eval-studio、insightface-desktop或者直接python -m insightface.gui。GUI 附加依赖包含PySide6-Essentials6.5、Pillow、reportlab和scikit-learn其中 scikit-learn 就是 DBSCAN 聚类所用的库。用户数据默认存放在~/.insightface/gui里面有 SQLite 数据库、人脸裁剪图、导出、报告和日志。需要换位置时insightface-gui --workspace /path/to/workspace如果缺少 GUI 依赖启动时会提示InsightFace GUI requires PySide6.按提示用pip install insightface[gui]补齐即可。先加载模型聚类依赖人脸检测与特征提取因此运行前必须加载模型从顶栏Models或Tools Models选择模型包buffalo_l、buffalo_s、antelopev2或自定义模型目录。GUI 不会自动下载模型。先在Models Downloads里点Refresh Download URLs拉取最新的 release 资产再手动下载Zip 包会解压到~/.insightface/models/model_name/。也可以把模型目录手动放到~/.insightface/models/下或在Models Runtime里选 custom model directory。provider 可选 Auto、CPU、CUDA仅当 ONNX Runtime 报告CUDAExecutionProvider可用时才有 CUDA。检测尺寸默认 Auto会同时跑 128x128 和 640x640 两级检测并合并重复框。如果没加载模型就点Import / Refresh页面会报错Model is not loaded. Please open Models.此时去 Models 里加载后重试。导入相册文件夹并跑聚类进入Album Management Album页面。把相册目录加入 Album directories 列表点击Add Folder选择目录也可以直接把一个或多个文件夹拖进列表。点Import / Refresh。它会递归扫描选中目录下的图片只为新图片提取特征并保存本地裁剪图然后对当前选中目录下的所有已索引人脸跑 DBSCAN 聚类。完成后状态栏会给出本次结果例如Imported 12 new image(s), saved 20 face(s), built 3 cluster(s).具体数字随你的相册变化。几个相关按钮的行为方便后续维护相册Import / Refresh增量导入。已索引过的图片不会重复提特征但仍会重新聚类。Rebuild All弹出确认框确认后从原始状态重新处理所有选中目录的图片并用新的结果替换已保存的聚类结果如果没有选中任何目录它的作用变为清空已保存的聚类结果同样会先询问确认。Clear只清除选中的相册目录不删除当前可见的聚类结果。调整相似度阈值页面在按钮下方有一组聚类参数参数取值范围默认值作用Cosine threshold0.01 ~ 0.99步长 0.010.48人脸相似度截止值越高聚类越严格Min samples1 ~ 502DBSCAN 核心点所需的最少邻居人脸数Minimum face size1 ~ 409680宽或高小于该值的人脸框会被跳过阈值是调分组松紧的主要旋钮把它调高同一人内部的合并更严格容易出现同一人被拆成多个簇调低则更激进地合并不同人可能被并入同一簇。内部实现上DBSCAN 收到的是余弦距离1 - cosine threshold最小0.01metric 为cosine如果 scikit-learn 不可用代码会退回到一个质心合并的 fallback 算法算法标签会显示为centroid fallback而不是DBSCAN。调整阈值后需要再次点Import / Refresh或Rebuild All让新参数生效——页面上的阈值是下一次聚类运行的输入不会在滑杆拖动时即时重算。查看聚类结果左侧表格列出每个人群簇缩略图取自距簇质心最近的人脸和该簇包含的照片数行 tooltip 里有 ID、名称、人脸数、照片数。选中某个簇后右侧表格显示该簇对应的全部原始照片缩略图、文件路径和照片内的人脸数双击缩略图会用系统默认程序打开原图。相册目录和聚类结果保存在本地 SQLite 数据库里下次启动页面会自动恢复上次的人群簇和参数设置。常见报错与日志Add one or more album directories first.目录列表为空先Add Folder或拖入文件夹。No supported images found in the selected directories.选中的目录里找不到受支持的图片文件检查路径里是否真的有图片。Model is not loaded. Please open Models.模型未加载去Models里选择并加载模型包。需要排查模型或 provider 问题时可以带参数启动insightface-gui --safe-mode本次启动不自动加载模型仅对当前这次启动生效不写入config.json或insightface-gui --provider cpu强制 CPU没有可用 CUDA provider 的机器上选 CUDA 时 GUI 会自动回退到 Auto/CPU。运行日志在~/.insightface/gui/logs/app.log。完成一次导入后建议先用默认阈值0.48看一眼人群簇拆分是否符合预期同一人被拆散就往下调阈值不同人混在一簇就往上调改完重跑Import / Refresh即可。【免费下载链接】insightfaceState-of-the-art 2D and 3D Face Analysis Project项目地址: https://gitcode.com/GitHub_Trending/in/insightface创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
