HivisionIDPhotos 使用教程

【免费下载链接】HivisionIDPhotos ⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 项目地址: https://gitcode.com/gh_mirrors/hi/HivisionIDPhotos

1. 项目介绍

HivisionIDPhotos 是一个开源的、轻量级的 AI 证件照制作工具。它通过一套完善的 AI 模型工作流程，实现了对多种用户拍照场景的识别、抠图与证件照生成。HivisionIDPhotos 支持纯离线或端云推理，具备美颜、智能换正装等功能（待实现），非常适合快速制作标准的证件照。

2. 项目快速启动

环境安装

确保您的 Python 版本为 3.7 或更高。操作系统支持 Linux、Windows 和 MacOS。

克隆项目到本地：

git clone https://github.com/xiaolin199912/HivisionIDPhotos.git
cd HivisionIDPhotos

安装依赖环境：

pip install -r requirements.txt
pip install -r requirements-app.txt

下载人像抠图模型权重文件，可以选择以下任一方式：

方式一：使用脚本下载

python scripts/download_model.py --models all

方式二：直接从网络下载模型文件并放到相应目录

下载完成后，将模型文件放到 hivision/creator/weights 目录下。

运行 Gradio Demo

python app.py

运行上述命令后，会自动生成一个本地 Web 页面，通过浏览器访问该页面，即可进行证件照的操作与交互。

3. 应用案例和最佳实践

以下是一些使用 HivisionIDPhotos 的案例和最佳实践：

证件照制作

使用提供的 Python 脚本，可以轻松制作证件照：

python inference.py -i demo/images/test0.jpg -o ./idphoto.png --height 413 --width 295

人像抠图

抠图功能可以将人像从背景中分离出来：

python inference.py -t human_matting -i demo/images/test0.jpg -o ./idphoto_matting.png --matting_model hivision_modnet

增加底色

为透明的人像图片增加底色：

python inference.py -t add_background -i ./idphoto.png -o ./idphoto_ab.jpg -c 4 -f83ce -k 30 -r 1

生成排版照

生成六寸排版照：

python inference.py -t generate_layout_photos -i ./idphoto_ab.jpg -o ./idphoto_layout.jpg --height 413 --width 295 --k 200

4. 典型生态项目

HivisionIDPhotos 的生态系统包括多个衍生项目，以下是一些典型的例子：

• HivisionIDPhotos-ComfyUI：一个基于 HivisionIDPhotos 的证件照处理工作流。
• HivisionIDPhotos-wechat-weapp：一个基于微信小程序的证件照应用。
• HivisionIDPhotos-web：证件照应用的网页版。
• HivisionIDPhotos-cpp：HivisionIDPhotos 的 C++ 版本。

以上是 HivisionIDPhotos 的基本使用教程，希望对您有所帮助。

【免费下载链接】HivisionIDPhotos ⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 项目地址: https://gitcode.com/gh_mirrors/hi/HivisionIDPhotos