AI 证件照一键生成：HivisionIDPhotos 从安装到出图的完整指南

AI 证件照一键生成：HivisionIDPhotos 从安装到出图的完整指南

【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos

急于一张标准证件照，或者需要一版六寸排版照拿去冲印？HivisionIDPhotos 就是一个轻量级的 AI 证件照制作工具：上传一张日常照片，它会自动抠出人像、按你指定的尺寸和底色生成标准照，还能直接产出排版照。整条流程纯本地运行，普通 CPU 就能跑。下面带你走一遍：从装环境、拉模型，到启动 Web 界面并产出第一张 AI 证件照。

一、开始前确认环境

先花一分钟检查你机器上有没有这些基础件，后面每一步都依赖它们：

• Python 3.7 或更高版本（推荐 3.10，项目就在这个版本上测试）
• pip：Python 自带的包管理器，用来装依赖库
• conda（推荐）：用来创建独立的虚拟环境，避免和项目外的库互相污染

确认方式很简单，终端里敲python --version和conda --version，都有正常输出就可以往下走。

二、拉取代码并安装依赖

第一步是把项目代码拿到本地，进入项目目录：

git clone https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos cd HivisionIDPhotos

预期结果：本地多了一个HivisionIDPhotos文件夹，终端提示符切到该目录内。

接下来用 conda 建一个干净的虚拟环境，再把依赖装进去。requirements.txt里是跑核心算法的库（比如 ONNX Runtime，一个专门用来运行 AI 模型的轻量推理引擎），requirements-app.txt里是搭 Web 界面用的 Gradio（一个用几行代码就能生成交互网页的库）：

conda create -n hivision_idphotos python=3.10 conda activate hivision_idphotos pip install -r requirements.txt pip install -r requirements-app.txt

预期结果：终端激活提示变成(hivision_idphotos)，两条 pip 命令跑完没有ERROR字样。如果 pip 下载慢，可以临时换成国内镜像源。

三、一条命令下载人像抠图模型

依赖装好还不能直接出图，因为抠图靠的是预训练模型权重文件（相当于模型的"大脑"，代码本身不包含它）。项目已经写好了下载脚本，一条命令把全部模型拉到项目里：

python scripts/download_model.py --models all

脚本会带进度条逐个下载，文件最终存放在hivision/creator/weights目录下。只想下载某个模型也可以指定，例如--models hivision_modnet。全部下完后终端会逐个打印保存路径，看到Download completed就说明成功了。

可选动作：默认的人脸检测用的是 MTCNN（离线、CPU 毫秒级，够用但精度一般）。如果追求更准的框脸效果，可以额外下载 RetinaFace 权重，放到hivision/creator/retinaface/weights目录下，界面里就会多出一个检测模型选项。

四、启动 Web 界面，产出第一张证件照

万事俱备，一条命令启动：

python app.py

启动成功后终端会打印出本地服务信息，这时打开浏览器访问 http://127.0.0.1:7860，就能看到操作界面：左侧上传一张只含一张人脸的照片，选好尺寸（比如一寸 413x295）和背景色，点"开始制作"。右侧面板会依次给出标准照、高清照和六寸排版照，每张旁边都有下载按钮。

如果启动时报"未找到任何存在的人像分割模型"，回到上一步确认hivision/creator/weights目录下是否已经有.onnx文件。

五、跑通之后还能做什么

• 改尺寸和底色：界面上的预设清单想加减，直接编辑demo/assets/size_list_CN.csv（第一列尺寸名、第二列高、第三列宽）和demo/assets/color_list_CN.csv，改完重新python app.py即生效。
• 用命令行批量出图：不需要界面时，python inference.py -i demo/images/test0.jpg -o ./idphoto.png --height 413 --width 295一条命令就能生成标准照和高清照，其余参数用python inference.py --help查看。
• 顺着目录读源码：抠图、人脸检测、排版逻辑都在hivision/creator/，美颜、水印等插件在hivision/plugin/；需要部署 API 服务时，参考 docs/api_CN.md，涉及 Face++ 在线检测时看 docs/face++_CN.md。

按这三条往下走，你就能把它从一个 Demo 变成自己日常出证件照的固定工具。

【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos