# Face comparison 人脸比对

**Repository Path**: wffly/Face-comparison

## Basic Information

- **Project Name**: Face comparison 人脸比对
- **Description**: 一个基于python3.9 编写的 用于远程视频和身份证头像截取 实现人脸比对的python脚本 支持php调用 目前还没有实现活体检测部分 有时间在研究吧。。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 1
- **Created**: 2020-06-16
- **Last Updated**: 2026-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 人脸对比系统
[![star](https://gitee.com/wffly/Face-comparison/badge/star.svg?theme=dark)](https://gitee.com/wffly/Face-comparison/stargazers)
[![fork](https://gitee.com/wffly/Face-comparison/badge/fork.svg?theme=gray)](https://gitee.com/wffly/Face-comparison/members)

## 📋 项目介绍

一个基于AI技术的高精度人脸对比系统，支持图片上传、人脸检测和相似度分析。系统采用现代化的Web界面设计，提供中英文多语言支持，可广泛应用于身份验证、人脸识别、安全监控等场景。

### ✨ 核心功能

- 🎯 **人脸对比**：精确计算两张人脸的相似度
- 📷 **图片上传**：支持本地上传和URL图片对比
- 🎨 **现代化界面**：科技感十足的响应式设计
- 🌐 **多语言支持**：中英文切换功能
- ⚙️ **阈值调节**：可自定义相似度判断标准
- 📱 **响应式布局**：适配PC和移动设备

- 🔒 **API密钥认证**：确保接口安全
- ⚡ **限流保护**：防止API滥用

## 🛠️ 技术栈

### 后端
- **语言**：Python 3.9+
- **框架**：Flask
- **AI引擎**：face_recognition (dlib)
- **依赖**：numpy, requests

### 前端
- **HTML5/CSS3**：现代化界面设计
- **JavaScript**：交互逻辑实现
- **响应式设计**：适配多种设备

### 部署
- **健康检查**：服务可用性监控

## 🚀 快速开始

### 环境要求

- Python 3.9+

- 操作系统：Ubuntu/CentOS/Debian/Windows

### 本地部署

```bash
# 克隆项目
git clone https://gitee.com/wffly/Face-comparison.git
cd Face-comparison

# 安装依赖
pip install -r requirements.txt

# 启动服务
python app.py
```

访问 `http://localhost:5000` 即可使用系统。



## 📡 API文档

### 人脸对比接口

#### 请求方式
POST /api/compare

#### 请求头
- Authorization: API密钥

#### 请求参数
- face1: 第一张人脸图片文件
- face2: 第二张人脸图片文件
- tolerance: 相似度阈值 (可选，默认0.5)

#### 响应示例

```json
{
  "code": 100,
  "message": "success",
  "is_match": true,
  "similarity": 85.36,
  "distance": 0.1464
}
```

### 健康检查接口

#### 请求方式
GET /health

#### 响应示例

```json
{
  "status": "ok",
  "message": "Face comparison service is running"
}
```

## ⚙️ 配置说明

### 环境变量

| 变量名 | 描述 | 默认值 |
|--------|------|--------|
| PORT | 服务端口 | 5000 |
| FLASK_ENV | 运行环境 | production |
| PYTHONUNBUFFERED | 日志输出 | 1 |

### 限流配置

在 `app.py` 中可调整限流参数：

```python
RATE_LIMIT = 5  # 每天最多调用次数
RATE_LIMIT_WINDOW = 24 * 60 * 60  # 窗口大小（秒）
```

## 📦 部署指南

详细的部署说明请参考 [DEPLOYMENT.md](DEPLOYMENT.md) 文件。

## 👨‍💻 开发指南

### 开发环境搭建

```bash
# 安装开发依赖
pip install -r requirements.txt

# 启动开发服务器
python app.py
```

### 代码结构

```
Face-comparison/
├── app.py              # 主应用文件
├── test.html          # 前端页面
├── requirements.txt   # 依赖文件

├── DEPLOYMENT.md      # 部署文档
└── README.md          # 项目说明
```

## 🤝 贡献指南

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 📄 许可证

本项目采用 Apache License 2.0 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 📞 联系方式

- **项目地址**：https://gitee.com/wffly/Face-comparison.git
- **反馈邮箱**：<411328093@qq.com>

## 🙏 致谢

- [face_recognition](https://github.com/ageitgey/face_recognition) - 提供人脸检测和识别能力
- [Flask](https://flask.palletsprojects.com/) - 轻量级Web框架


---

**最后更新**：2026-01-14
**版本**：v1.0