企业官网建设流程全解析

用 HivisionIDPhotos 快速生成 AI 证件照：完整安装与上手教程

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

如果你需要一张能直接打印的证件照，又不想去照相馆排队，HivisionIDPhotos 可以帮你用 AI 一键搞定：上传一张自拍，它自动完成抠图、美颜，再按你要的尺寸生成标准证件照或整版排版照。这篇证件照安装教程会带你从拉代码到跑通 Web 界面，全程只用基础命令。

它到底能帮你做什么

扔给它一张日常照片（甚至手机前置摄像头的自拍），它会识别人脸、把人从背景里抠出来、换成纯色背景，再根据你选的规格输出对应尺寸的证件照，还支持一张照片排版成六寸相纸那样的整版排版照。整个流程是本地跑的，模型基于 ONNX Runtime 推理，CPU 就能用，不挑显卡。

动手前备齐三样东西

• ✅ Python 3.7 以上（推荐 3.10）
• ✅ pip（装 Python 时一般自带）
• ✅ conda（推荐，用来隔离环境，新手用虚拟环境不容易污染系统）

这三样齐了就可以开始，下面每步都只需要复制粘贴一条命令。

四步跑通：从拉代码到出照片

第一步：把代码拉到本地

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

第二步：装好 Python 依赖，一条命令搞定

先建一个干净的虚拟环境再激活，然后依次装两份依赖清单：

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)前缀出现在提示符前就说明环境准备好了。

第三步：下载 AI 模型，别跳过这步

抠图、人脸检测等能力都靠预训练模型驱动，权重文件需要单独下载，缺了它程序会直接报错：

python scripts/download_model.py --models all

脚本会显示下载进度条，全部完成后权重会放到hivision/creator/weights/目录下。

第四步：打开网页，开始做照片

python app.py

跑起来之后看一眼

看到日志打印出本地地址后，浏览器打开http://127.0.0.1:7860就能看到操作界面：上传照片、选背景色和尺寸规格、勾选美颜，点生成即可。

⚡ 常见报错速查：如果提示7860 端口被占用，说明端口被别的程序占了，先关掉占用它的进程再启动，或者用任务管理器/lsof -i:7860查一下是谁占的。

想深入可以继续看

想改尺寸规格或美颜参数，可以直接翻 demo/ 目录下的配置文件和处理器逻辑，接口细节则参考 docs/api_CN.md。

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