HivisionIDPhotos

HivisionIDPhotos是一款专注于证件照制作的实用型开源AI工具。它由开发者Zeyi-Lin创建，利用一套完善的AI模型工作流程，实现对多种用户拍照场景的智能识别、精准抠图与标准证件照生成。与许多依赖云端算力的商业应用不同，HivisionIDPhotos的一个显著特点是轻量级，甚至可以在仅配备CPU的电脑上快速推理，无需昂贵显卡。它既能满足个人应急制作证件照的需求，也为开发者提供了灵活的API以便集成到各类应用中，是GitHub上颇受欢迎的项目之一，曾登上热榜。

官网入口地址

项目GitHub仓库：https://github.com/Zeyi-Lin/HivisionIDPhotos

下载地址

该工具主要面向开发者，可通过GitHub克隆代码进行部署。同时，它也提供了在线演示地址供用户体验，以及Docker镜像方便快速部署。

在线演示（体验版）：

• Hugging Face 演示空间：https://huggingface.co/spaces/TheEeeeLin/HivisionIDPhotos

• ModelScope 演示空间：https://modelscope.cn/studios/SwanLab/HivisionIDPhotos

Windows客户端：社区开发者提供了Windows GUI版本，下载地址可参考项目社区说明。

功能介绍

HivisionIDPhotos的功能覆盖了证件照制作的全流程，具体包括：

轻量级AI抠图：采用MODNet、RMBG等多种抠图模型，能高效地将人像从复杂背景中分离，尤擅长处理发丝等细节区域。整个过程可在本地CPU上运行，无需联网。

多尺寸标准证件照生成：内置了一寸、二寸、六寸等常见证件照尺寸预设。用户也可根据护照、签证、教师资格证等特定要求，自定义照片的高度、宽度和分辨率。

背景替换与渲染：支持一键将背景更换为蓝色、白色、红色等纯色。还提供了上下渐变和中心渐变等背景渲染模式，让证件照看起来更自然。

六寸排版照生成：可以将制作好的标准证件照自动排列生成六寸排版照，方便直接打印裁剪，一次性获得多张证件照。

人像美颜：在后续版本中已加入了基础美颜功能，能让照片看起来更精神。

多部署与集成方式：提供了极灵活的部署选项，包括Gradio网页界面（Web UI）、Python API服务（基于FastAPI）、Docker容器化部署以及命令行（CLI）推理。这使得它既可以作为个人工具，也可以轻松集成到网站、小程序等第三方应用中。

应用场景

HivisionIDPhotos的应用场景非常具体和广泛。个人用户可以在家中用生活照快速制作简历照、考试报名照（如考研、公务员、教师资格证等）。开发者可以将它集成到自己的小程序、网站或应用中，提供证件照制作功能。在无法连接互联网或注重数据隐私的环境下，离线的特性也非常实用。

使用方法

HivisionIDPhotos的使用方式主要分为三类：

1. 在线演示体验（无需安装）
直接访问Hugging Face或ModelScope的演示空间，上传照片，选择尺寸和背景色，点击制作即可下载。

2. 本地部署运行
对于追求隐私、需要长期使用或进行开发集成的用户，可以采用本地部署。

• Docker部署（推荐）：在已安装Docker的电脑上，运行一条命令即可拉取镜像并启动服务，然后通过浏览器访问 http://127.0.0.1:7860 使用。

  bash

  docker run -d -p 7860:7860 linzeyi/hivision_idphotos

• 源码部署：适合开发者。克隆项目，安装Python依赖，并下载模型权重文件后，通过 python app.py 即可启动Web界面。

3. 命令行快速推理
适合熟悉命令行的用户，可直接使用 inference.py 脚本进行抠图、换底色、生成排版照等操作。

服务支持

HivisionIDPhotos是一个开源免费的项目，采用MIT许可证，允许自由使用和修改。它由开发者个人及社区共同维护，用户可以通过GitHub提交Issue、参与讨论或贡献代码。目前主要面向开发者与个人用户，无官方付费支持计划，但活跃的社区能提供丰富的部署教程和常见问题解答。