HivisionIDPhotos 手把手部署指南：四步在电脑上跑通 AI 证件照生成工具

HivisionIDPhotos 手把手部署指南四步在电脑上跑通 AI 证件照生成工具【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos急需一张证件照却抽不出时间跑照相馆HivisionIDPhotos 是一款轻量级开源的 AI 证件照生成工具上传一张照片它就能自动抠图、换底色一键做出各种标准尺寸的证件照和排版照。无论你是程序员还是只想在自己电脑上做照片的普通用户跟着这份指南四步就能完成部署。HivisionIDPhotos 是什么HivisionIDPhotos 解决的是一件很具体的小事临时要交证件照但手头只有手机拍的普通照片。它利用一套 AI 模型工作流自动完成人脸检测、人像抠图、换底色、排版等全部步骤全程纯离线运行普通 CPU 就能跑对电脑配置几乎零门槛。典型使用场景包括 不同尺寸的标准证件照一寸、二寸或按像素/毫米自定义尺寸️ 六寸排版照直接拿去冲印 一键换底色蓝、白、红等标准底色还带美颜和水印功能下面这几张就是它生成证件照的实际效果红底、蓝底、白底、渐变底都支持技术栈一览项目整体用 Python 编写核心依赖如下表不需要你了解原理知道各自负责什么就行组件在项目中扮演的角色AI 模型人像抠图 / 人脸检测核心算法负责把人从背景里分离出来并定位人脸PyTorch深度学习框架为模型推理提供底层支持GPU 加速时可选ONNX Runtime跨平台推理引擎负责在 CPU 上高效执行抠图等模型Gradio快速搭建交互式 Web 界面的库你在浏览器里看到的那个页面就是它生成的部署前环境自检开始前花一分钟确认三件事能避免后面大多数报错Python 3.7 及以上项目主要在 3.10 上测试推荐直接装 3.10pip 可用Python 的包管理器Python 3.4 一般自带conda推荐用它创建隔离环境最省心 打开终端分别输入python --version、pip --version、conda --version能看到版本号就说明已就绪。缺哪个补哪个即可。四步完成部署① 获取项目代码目的把项目全部源码拿到本地。打开终端执行下面的命令克隆仓库并进入项目目录git clone https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos cd HivisionIDPhotos✅你会看到当前目录下出现一个HivisionIDPhotos文件夹进入后能看到app.py、requirements.txt、scripts/等文件。② 创建隔离环境并安装依赖目的给这个项目准备一个专用的 Python 环境装依赖时不会弄乱你电脑上其他软件。先让 conda 创建一个 3.10 的新环境并激活它再依次安装两份依赖清单requirements.txt是核心算法依赖requirements-app.txt是 Web 界面依赖conda create -n hivision_idphotos python3.10 conda activate hivision_idphotos pip install -r requirements.txt pip install -r requirements-app.txt✅你会看到终端提示符前多出一段(hivision_idphotos)最后 pip 输出Successfully installed ...说明安装完成。③ 下载预训练模型权重目的抠图和人脸检测都要加载模型文件这一步不做好后面启动会直接报错。运行仓库自带的下载脚本把所有模型一次性拉下来脚本见 scripts/download_model.pypython scripts/download_model.py --models all✅你会看到终端里出现多个模型的下载进度条文件会保存进hivision/creator/weights目录。如果只想要某个模型把all换成模型名即可例如--models modnet_photographic_portrait_matting。④ 启动 Web 界面目的把 Gradio 网页跑起来之后所有操作都在浏览器里完成。在项目根目录执行python app.py✅你会看到终端打印出类似Running on local URL: http://127.0.0.1:7860的字样服务就跑起来了。启动验证与快速上手 打开浏览器访问http://127.0.0.1:7860你会看到这样一个页面左侧照片上传区 证件照尺寸选项尺寸列表 / 只换底色 / 自定义尺寸 背景色选择下方还有核心参数头身比例等、高级参数、美颜、水印等选项卡右侧结果区分「标准照」「高清照」「六寸排版照」三块操作路径很简单在左侧上传一张人像照片选好尺寸和背景色默认蓝色一寸照不用改也能出片点「开始制作」等几秒钟右侧会依次出现标准照、高清透明底大图和一张排好版的六寸照每张右上角都有下载按钮下载文件默认 300DPI冲印够用。常见问题速查❓ 模型下载很慢或中途断了怎么办直接重跑同一条命令即可脚本会跳过已下载完成的文件相当于断点续传。也可以改用--models 模型名一次只下一个失败重跑单个模型更快。❓ 提示端口 7860 被占用启动时加一个参数换端口python app.py --port 7861然后浏览器访问http://127.0.0.1:7861就行。❓ 启动时报「未找到任何存在的人像分割模型」说明第 ③ 步的权重没下载成功回到python scripts/download_model.py --models all确认hivision/creator/weights目录下已有.onnx文件再重新启动即可。部署到这里就全部完成了。现在就可以打开浏览器传一张照片试试 AI 证件照生成几十秒后你就能下载属于自己的标准证件照如果想把它做成一个可调用的 API 服务也可以看看仓库里的 API 文档动手试试吧【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考