# HelloFace

**Repository Path**: onDeviceAI/HelloFace

## Basic Information

- **Project Name**: HelloFace
- **Description**: 离线人脸检测、采集、活体、1:1 比对及 1:N/M:N 搜索 SDK，支持Android、iOS、Harmony、Windows 、Linux 。也会支持小程序和Flutter，RN，uniapp 插件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-11-04
- **Last Updated**: 2026-11-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 人脸识别, 多平台, 活体检测, 鸿蒙人脸识别, Linux人脸识别

## README

<h3 align="left">
  <a href="README.md">English</a> · <strong>简体中文</strong> · <a href="docs/readme/README.es.md">Español</a> · <a href="docs/readme/README.pt-BR.md">Português (Brasil)</a><br>
  <a href="docs/readme/README.fr.md">Français</a> · <a href="docs/readme/README.de.md">Deutsch</a> · <a href="docs/readme/README.ja.md">日本語</a> · <a href="docs/readme/README.ko.md">한국어</a> · <a href="docs/readme/README.ms.md">Bahasa Melayu</a>
</h3>

<p align="left">
  <img src="images/technology-badges.svg" alt="本地计算 · 原生 SDK · 五个平台" width="349" height="20">
</p>

<br>

<div align="center">
  <p>
    <a href="https://www.helloface.dev/zh/"><img src="images/hello-face-icon.webp" alt="" width="51" height="51" align="bottom"><img src="images/helloface-wordmark.svg" alt="HelloFace" width="170" height="40" align="bottom"></a>
    &nbsp; <strong>0.8.8 Beta</strong>
  </p>
  <p><strong>离线人脸检测、采集、活体、1:1 比对及 1:N/M:N 搜索。</strong></p>
  <p>🌍 <strong>官方网站</strong> · <a href="https://www.helloface.dev">helloface.dev ↗</a> &nbsp; | &nbsp; <img src="images/github-mark.svg" alt="" width="16" height="16" align="bottom"> <strong>GitHub 集成源码</strong> · <a href="https://github.com/FaceSDKPro/HelloFace">FaceSDKPro/HelloFace</a></p>
</div>

<br>

<table>
  <tr>
    <th align="left" nowrap>功能</th>
    <th align="left">说明</th>
  </tr>
  <tr>
    <td align="left" nowrap>🔒 <strong>离线与隐私</strong></td>
    <td align="left">在本地处理人脸数据，无需将图像或人脸特征上传至云端。 <a href="docs/privacy/DATA_PROCESSING_AND_PRIVACY.zh-CN.md"><strong>更多</strong></a></td>
  </tr>
  <tr>
    <td align="left" nowrap>🎯 <strong>人脸能力</strong></td>
    <td align="left">支持人脸检测、特征提取、活体检测、1:1 验证及 1:N/M:N 搜索。</td>
  </tr>
  <tr>
    <td align="left" nowrap>🌍 <strong>跨平台支持</strong></td>
    <td align="left">已经支持 Android · iOS · HarmonyOS · Windows · Linux；更多平台请期待或提 <a href="https://github.com/FaceSDKPro/HelloFace/issues">issues</a> 描述需求。</td>
  </tr>
  <tr>
    <td align="left" nowrap>🧩 <strong>便捷接入</strong></td>
    <td align="left">通过 SDK API、接入指南和可自定义的 Demo 快速开始开发。</td>
  </tr>
  <tr>
    <td align="left" nowrap>⚡ <strong>实时处理</strong></td>
    <td align="left">毫秒级别实时人脸检测、验证与搜索。</td>
  </tr>
</table>

<details>
  <summary><strong>展开产品概览与应用场景</strong></summary>
  <p align="center"><img src="images/AboutHelloFace.png" alt="HelloFace 产品概览与应用场景" width="100%"></p>
</details>

## 平台接入

| 平台 | 环境 | 接入说明 |
|---|---|---|
| Android | Android 6.0+ · ARM64/ARMv7/X86 · JDK 11 | [Demo](platforms/Android/README.zh-CN.md) · [SDK](platforms/Android/docs/SDK.zh-CN.md) |
| iOS | iOS 15+ · Swift 6 · Xcode | [Demo](platforms/iOS/README.zh-CN.md) · [SDK](platforms/iOS/SDK/API.zh-CN.md) |
| Harmony | HarmonyOS API 20+ · ARM64 · DevEco Studio 26 | [Demo](platforms/Harmony/README.zh-CN.md) · [SDK](platforms/Harmony/SDK.zh-CN.md) |
| Linux | Ubuntu 22.04+ · x86_64/ARM64 · X11/XWayland | [Demo](platforms/Linux/README.zh-CN.md) · [SDK](platforms/Linux/runtimes/x86_64/sdk/README.zh-CN.md) |
| Windows | Windows 10/11 x64 · CPU | [Demo](platforms/Windows/README.zh-CN.md) · [SDK](platforms/Windows/sdk/README.zh-CN.md) |
| Web 人脸录入 | 浏览器 | [在线体验](https://hiface-mdp.pages.dev/face/) |

**更多平台（计划）：** 将支持微信小程序、ChromeOS、uni-app、Flutter 插件、React Native（RN）插件等。

## 获取代码

本仓库使用 Git LFS 管理 SDK 二进制等大文件，若只需默认分支的最新提交，建议使用浅克隆以跳过历史提交：

```bash
git clone --depth 1 --single-branch https://github.com/FaceSDKPro/HelloFace.git
```

## 部署须知

- 各平台Demo UI仅供演示SDK，你可以自由定制你的UI交互。
- SDK正在Beta 迭代公测中，请及时升级SDK版本。
- 当前模型不支持12周岁以下儿童人脸识别，不能用于金融相关场景。
- 人脸搜索识别要求摄像头成像清晰；室外环境下，摄像头宽动态范围须大于 100 dB。
- Windows/Linux 桌面与摄像头待真机摄像头验证；移动端运行需配置自己的应用签名。

## 联系我们

其他平台在完善支持中，有问题请提 issues。

邮箱联系：[FaceAISDK.Service@gmail.com](mailto:FaceAISDK.Service@gmail.com)

<table>
  <tr>
    <th align="center">Android APK 下载</th>
    <th align="center">微信联系</th>
  </tr>
  <tr>
    <td align="center">
      <a href="https://www.pgyer.com/HelloFace"><img src="images/AndroidAPK.png" alt="Android APK 下载二维码" width="180"></a><br>
      <a href="https://www.pgyer.com/HelloFace">点击或扫码下载</a>
    </td>
    <td align="center">
      <img src="images/WeChat.jpg" alt="微信二维码" width="180"><br>
      扫码联系
    </td>
  </tr>
</table>