# spring-boot-seetaface6

**Repository Path**: crazy-of-pig/spring-boot-seetaface6

## Basic Information

- **Project Name**: spring-boot-seetaface6
- **Description**: spring boot , pgvector, mybatis-plus, 人脸向量搜索
- **Primary Language**: Java
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 64
- **Forks**: 34
- **Created**: 2022-10-24
- **Last Updated**: 2025-12-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# spring-boot-seetaface6 Spring Boot 人脸识别

## 介绍

本项目是一个基于 Spring Boot 的人脸识别项目，主要特点如下：

1. 基于 [SeetaFace6 SDK](https://gitee.com/crazy-of-pig/seeta-sdk-platform.git)，使用其人脸识别功能。
2. 将各种人脸识别组件配置为 Spring Bean，便于在 Spring Boot 项目中使用。
3. 使用 [pgvector](https://github.com/pgvector/pgvector) 作为向量数据库，结合 MyBatis Plus 操作向量数据类型。
4. 自动建表和创建索引，只需配置数据库参数即可运行项目。

## 演示 API

项目展示了以下常见的人脸识别 API：

- 1:1 人脸匹配
- 1:N 人脸搜索

## 软件架构

- PostgreSQL (pgvector)
- Spring Boot
- MyBatis Plus
- SeetaFace6 SDK

## 使用说明

1. **运行项目**：
   - 下载 SeetaFace6 的模型文件，并将路径配置到 `application.yml` 中。
   - 默认模型文件放置在项目目录下的 `models` 文件夹中。

2. **访问 Swagger UI**：
   - 启动项目后，访问 `http://localhost:8018/seetaface6/swagger-ui.html` 进行 API 调试。

## Docker 部署

项目提供 Dockerfile，用于构建和运行项目：

```Dockerfile
# 使用官方 Java 8 镜像
FROM openjdk:8

# 设置 PostgreSQL 数据库连接信息
ENV DB_URL=jdbc:postgresql://127.0.0.1:5432/mytest
ENV DB_USER=pgvector
ENV DB_PASS=pgvector

# 安装 libgomp1 库
RUN apt-get update && \
    apt-get install -y --no-install-recommends libgomp1 && \
    rm -rf /var/lib/apt/lists/*

# 创建目录
RUN mkdir -p /app && mkdir -p /app/models

# 复制 JAR 包和模型文件
COPY ./target/spring-boot-seetaface6-1.0.0.jar /app/spring-boot-seetaface6-1.0.0.jar
COPY models/*.csta /app/models/

# 设置工作目录
WORKDIR /app

# 启动命令
CMD ["java", "-jar", "spring-boot-seetaface6-1.0.0.jar"]
```

## 主要功能模块

- **人脸识别**：提供 1:1 和 1:N 的人脸识别功能。
- **人脸属性检测**：包括性别识别、年龄预测、口罩检测、活体检测等。
- **向量数据库**：使用 pgvector 存储和查询人脸特征向量。
- **文件管理**：支持文件上传和管理功能。

## 贡献

欢迎贡献代码和建议，帮助项目不断完善。

## 许可证

本项目遵循 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。