HivisionIDPhotos 安装教程15 分钟本地部署免费 AI 证件照工具【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotosHivisionIDPhotos 是一个轻量级 AI 证件照工具上传一张随手拍的照片它自动完成抠图、换底色、排版产出标准证件照和排版照。本教程带你本地部署这套工具全程约 15 分钟完成后你会拥有一个本地网页打开浏览器传图即可出证件照。30 秒了解 HivisionIDPhotos 能做什么去照相馆拍证件照要排队、要钱自己拍照又要调背景、修尺寸。它解决的就是这件事你只管传一张照片抠图、换底色、按规格排版这些活它全干了全程离线、纯 CPU 就能跑。技术在项目中负责什么抠图模型hivision_modnet 等把人像从背景干净切出支持换底色MTCNN / RetinaFace定位人脸控制构图与头身比例ONNX Runtime跑 .onnx 权重CPU 即可推理Gradio拖拽式 Web 界面传图即出片FastAPI对外暴露 API便于服务化接入安装前环境自检清单检查项为什么需要怎么确认Python ≥ 3.7推荐 3.10依赖库对解释器版本有要求运行python --versionconda隔离独立环境避免依赖打架运行conda --version约 2GB 磁盘 稳定网络模型权重是 .onnx 文件需一次性下载查看系统磁盘剩余空间HivisionIDPhotos 本地部署4 步最快启动方式拉取代码把源码下载到本地。git clone https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos cd HivisionIDPhotos✅ 完成标志目录里出现app.py、hivision/子目录和scripts/download_model.py。搭建独立环境建一个 Python 3.10 隔离环境并装齐依赖。conda create -n hivision_idphotos python3.10 conda activate hivision_idphotos pip install -r requirements.txt pip install -r requirements-app.txt✅ 完成标志终端执行pip list能看到gradio、onnxruntime、opencv-python三个包。下载抠图模型权重不在仓库里跑一次下载脚本即可只需一个抠图模型就能启动。python scripts/download_model.py --models hivision_modnet✅ 完成标志终端打印Download completed. Save to: ...且hivision/creator/weights/下出现hivision_modnet.onnx。启动服务把 Web 界面拉起来。python app.py✅ 完成标志终端打印Running on local URL: http://127.0.0.1:7860。验证跑通与常见问题速查浏览器打开 http://127.0.0.1:7860看到左侧 Image 上传框、右侧有尺寸与底色选择区就是跑通了。从demo/images/test0.jpg传一张示例图即可得到一整套证件照。问启动时报No existing portrait segmentation model was found说明抠图权重没下到位。重跑python scripts/download_model.py --models all再确认hivision/creator/weights/下有 .onnx 文件。问模型下载慢或中途断线脚本会自动跳过已存在文件重跑同一条命令即可续传也可以只补单个模型如--models rmbg-1.4。问7860 端口被占用用python app.py --port 7861换端口启动浏览器相应改为访问 7861 端口。跑通之后两个进阶方向试参数拿demo/images/里的照片把不同尺寸、底色都跑一遍想改预设尺寸和颜色编辑 demo/assets/size_list_CN.csv、demo/assets/color_list_CN.csv 后重跑app.py即可。接入 API想在自己的系统里调用证件照能力看 API 文档 里的接口说明或直接读 deploy_api.py 了解服务化部署。【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考