一、简介

HivisionIDPhotos 是一个轻量级且高效的 AI 证件照制作工具，由 Zeyi Lin 和 SwanLab 团队开发。它利用先进的 AI 模型，实现对多种用户拍照场景的识别、抠图与证件照生成。

HivisionIDPhotos 的主要特点：

  • 轻量级抠图：仅需 CPU 即可快速推理，无需 GPU 加速。
  • 多种尺寸支持：支持生成不同尺寸的标准证件照和六寸排版照。
  • 美颜功能：提供美颜功能，提升证件照的视觉效果。
  • 智能换正装：未来将支持智能换正装功能，进一步提升证件照的专业性。
  • 离线和端云推理：支持纯离线或端云推理，灵活适应不同使用场景。

项目地址： https://github.com/Zeyi-Lin/HivisionIDPhotos

二、Docker 部署

Docker 是一个开源的应用容器引擎，可以轻松地部署和管理各种应用。使用 Docker 部署 HivisionIDPhotos 可以大大简化安装和配置过程。以下是详细的部署步骤：

1. 安装 Docker

#确保你的系统已安装 Docker。如果未安装，可以参考 Docker 官方文档进行安装：
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
sudo systemctl enable docker

2. 拉取 Docker 镜像

#拉取镜像
docker pull linzeyi/hivision_idphotos
# 国内拉取镜像失败可使用下面的代理拉取
docker pull docker-registry.xiyangai.top/linzeyi/hivision_idphotos

注：如果国内拉取镜像失败，请参考这篇文章，使用 cloudflare 构建自己的 dockerhub 代理。
文章地址：面对docker镜像加速站的纷纷关闭，如何通过cloudflare白嫖个人docker镜像加速服务

3. 启动 Gradio Demo 服务

#运行以下命令启动 HivisionIDPhotos 服务：
docker run -itd --name idphoto --restart=always -p 7860:7860 linzeyi/hivision_idphotos
  • -d 表示后台运行容器。
  • -p 7860:7860 将容器的 7860 端口映射到宿主机的 7860 端口，这是 Gradio Demo 服务的默认端口。

4. 启动 API 后端服务

# API 后端服务
docker run -itd --name idphoto --restart=always -p 8080:8080 linzeyi/hivision_idphotos python3 deploy_api.py

5. 验证服务是否运行正常

打开浏览器，访问 http://127.0.0.1:7860，如果看到 HivisionIDPhotos 的 Web 界面，说明服务已成功启动。

web主页

三、简单使用

HivisionIDPhotos 的 Web 界面提供了丰富的功能，用户可以通过简单的操作生成高质量的证件照。

证件照制作

HivisionIDPhoto 是一款功能强大、安装便捷的 AI 证件照制作工具。希望大家能够利用这款工具，轻松制作出满意的证件照，不再花费冤枉钱。