HivisionIDPhotos全套整合包：离线AI证件照制作神器，一键抠图换底色（附整合包）

整合包下载地址：📦 [点击进入网盘下载链接]

---

🌈 一、项目简介

HivisionIDPhoto 是一个轻量级、跨平台的 AI 证件照制作工具。
它集成了人像抠图、自动换底、智能裁剪与标准排版等功能，可在 纯离线环境（仅CPU） 下快速运行。

💡 适合：

• 想快速生成证件照的个人 / 开发者 / 摄影工作室
• 需要私有化部署、局域网使用的企业或教育机构
• 希望学习 AI 图像推理、模型部署流程的程序员

---

🧩 二、项目特性

✅ AI抠图：集成 MODNet / RMBG / BiRefNet 等高精度模型
✅ 智能裁剪：自动检测人脸并生成标准证件照尺寸（如1寸、2寸等）
✅ 换底色：支持多种背景色与HEX自定义
✅ 离线运行：CPU即可使用，无需GPU
✅ 排版打印：支持3R、4R、5寸、6寸、A4等多种版面
✅ 一键启动：Gradio WebUI 交互式操作界面
✅ API / Docker / Python 推理 全支持

---

⚙️ 三、环境准备与安装

建议使用 Python 3.10+（已在 macOS、Windows、Linux 上验证）

git clone https://github.com/Zeyi-Lin/HivisionIDPhotos.git
cd HivisionIDPhotos
pip install -r requirements.txt
pip install -r requirements-app.txt

模型权重可通过脚本下载：

python scripts/download_model.py --models all

⚠️ 如果下载缓慢，可使用我整合的「完整离线包」
📦 网盘链接见文末（已内置全部模型权重与依赖环境）

---

🖥 四、一键启动 Demo

python app.py

打开浏览器访问：
👉 http://127.0.0.1:7860

即可进入如下界面：

---

💻 五、命令行推理示例

功能	命令示例
生成证件照	python inference.py -i test.jpg -o idphoto.png --height 413 --width 295
人像抠图	python inference.py -t human_matting -i test.jpg -o output.png
换底色	python inference.py -t add_background -i idphoto.png -o new_bg.jpg -c 4f83ce
六寸排版	python inference.py -t generate_layout_photos -i idphoto.jpg -o layout.jpg

可使用 python inference.py --help 查看所有参数

---

🧰 六、Docker 一键部署

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

访问：
👉 http://127.0.0.1:7860 即可使用 Web 界面。

也可同时启用后端 API 服务：

docker run -d -p 8080:8080 linzeyi/hivision_idphotos python3 deploy_api.py

---

💡 七、常见问题（FAQ）

问题	解决方案
修改尺寸与颜色	修改 demo/assets/size_list_CN.csv 与 color_list_CN.csv
替换水印字体	修改 hivision/plugin/watermark.py 的 font_file 参数
自定义打印排版	修改 demo/locales.py 的 print_switch 配置
加入自定义模板照	添加图片至 hivision/plugin/template/assets/ 并更新配置文件

---

🔍 八、性能表现（Mac M1 Max测试）

模型组合	内存占用	推理时长(512×715)
MODNet + mtcnn	410MB	0.21s
MODNet + retinaface	405MB	0.57s
BiRefNet + retinaface	6.2GB	7.1s

即使仅使用 CPU，也能在 1 秒内完成抠图 + 证件照输出。

---

🌍 九、社区生态与扩展项目

应用方向	项目
C++ 版本	HivisionIDPhotos-cpp
微信小程序	HivisionIDPhotos-wechat-weapp
UniApp 小程序	HivisionIDPhotos-Uniapp
Windows 桌面版	HivisionIDPhotos-windows-GUI
NAS 部署教程	HivisionIDPhotos-NAS

---

📦 十、整合包下载（推荐）

为了方便国内用户，我整理了一个 一键运行的 HivisionIDPhoto 整合包
✅ 含：

• 完整源码
• 模型权重
• Python 3.10 环境
• 一键启动脚本

📎 下载地址：
整合包下载地址：📦 [点击进入网盘下载链接]