三步搞定：AI证件照本地部署完整指南

三步搞定AI证件照本地部署完整指南【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotosHivisionIDPhotos 是一款轻量级的 AI 证件照制作工具上传一张自拍就能自动检测人脸、抠出人像、换底色、做美颜。照下面三步走5 分钟后你就能在自己的浏览器里做出证件照。一句话看懂 HivisionIDPhotos它是个纯离线的证件照制作工具。给一张照片它自动完成人脸检测、人像抠图和底色替换还能按各种规格生成标准证件照和六寸排版照。适合需要应急办证、备考报名的场景CPU 就能跑不挑显卡。环境准备动手前先确认这几样齐了✅ Python 3.7建议 3.10✅ conda或 pip✅ 500MB 左右空闲磁盘Linux、Windows、macOS 都能装。分三步装好① 拿到项目把仓库克隆到本地并进入目录git clone https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos cd HivisionIDPhotos预期结果目录下能看到app.py、hivision/、scripts/这些文件和文件夹。② 建环境装依赖用 conda 新建一个干净的 Python 3.10 环境然后一次装好两份依赖清单。推理内核基于 onnxruntime界面层是 Gradio装完就齐了conda create -n hivision python3.10 -y conda activate hivision pip install -r requirements.txt -r requirements-app.txt预期结果安装过程一路正常结束没有报错最后能看到 Gradio 安装成功的提示。③ 下载模型权重抠图模型文件不随仓库分发需要单独下载下载脚本 一条命令全包python scripts/download_model.py --models all预期结果.onnx权重逐个落到hivision/creator/weights/目录其中至少要有一个抠图模型如hivision_modnet.onnx。启动与验证在项目根目录运行python app.py预期结果终端打印出本地访问地址。用浏览器打开 http://127.0.0.1:7860 看到可以上传照片、选尺寸和底色、一键下载的证件照操作页就说明部署成功了。 嫌装环境麻烦的话也可以直接拉官方 Docker 镜像跑README 里 Docker 部署一节有完整命令。常见坑1. 启动时报未找到任何存在的人像分割模型原因权重没下载或放错目录。解法重新执行python scripts/download_model.py --models all确认文件在hivision/creator/weights/里。2. pip 装依赖又慢又卡原因默认源在国外。解法安装命令末尾加-i https://pypi.tuna.tsinghua.edu.cn/simple换国内源。3. 提示 7860 端口被占用原因其他程序占了端口。解法改用python app.py --port 7861浏览器地址端口同步改成 7861。接下来可以改demo/assets/size_list_CN.csv自定义尺寸规格或把服务化接口接进自己的系统API 文档 里有 cURL 和 Python 两种请求示例。【免费下载链接】HivisionIDPhotos⚡️HivisionIDPhotos: a lightweight and efficient AI ID photos tools. 一个轻量级的AI证件照制作算法。项目地址: https://gitcode.com/GitHub_Trending/hiv/HivisionIDPhotos创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考