如果经常需要美化证件照片HiVisionIDPhotos一定是个完美的选择,调整不同证件照片尺寸,构图剪裁完整功能一键部署制作。
一、HiVisionIDPhotos 是什么?
HiVisionIDPhotos 是一个基于 Python + 深度学习 的开源证件照生成工具，能够实现自动抠图、背景替换、美化处理、尺寸裁剪等功能。它支持一寸照、二寸照、护照照等多种规格，适合本地部署使用，无需联网、不上传隐私照片，在证件照制作领域非常受欢迎。
二、安装前的准备工作
在安装 HiVisionIDPhotos 之前，请先确认你的电脑满足以下基本条件。
1. 操作系统要求
Windows 10 / 11(64 位)
macOS(Intel 或 Apple Silicon)
Linux(Ubuntu、Debian 等主流发行版)
2. 必须安装的软件
Python 3.8 – 3.10（强烈推荐 3.9）
Git（用于拉取项目源码）
不建议使用 Python 3.11 及以上版本，可能会出现依赖不兼容问题。
三、安装 Python(未安装可跳过)
Windows
前往 Python 官网下载 Python 3.9.x
安装时务必勾选：
Add Python to PATH
安装完成后打开命令行，输入：
python –version
显示版本号即说明成功
macOS / Linux
系统通常自带 Python，但版本可能较旧，建议使用：
python3 –version
若不是 3.8–3.10.可通过 Homebrew 或系统包管理器安装指定版本。
星宇智算官网支持免费部署立马安装！点击下方立即试用!
四、获取 HiVisionIDPhotos 源码
1. 打开终端 / 命令行
在任意目录执行：
git clone https://github.com/Zeyi-Lin/HiVisionIDPhotos.git
等待下载完成后，进入项目目录：
cd HiVisionIDPhotos
五、创建并激活虚拟环境(强烈推荐)
使用虚拟环境可以避免依赖冲突。
Windows
python -m venv venv venv\Scripts\activate
macOS / Linux
python3 -m venv venv source venv/bin/activate
激活成功后，命令行前会出现 (venv) 标识。
六、安装项目依赖(关键步骤)
1. 升级 pip
pip install –upgrade pip
2. 安装 requirements
pip install -r requirements.txt
此步骤可能需要几分钟，涉及深度学习相关库，请耐心等待。
如果下载速度慢，可使用国内镜像：
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
七、启动 HiVisionIDPhotos
依赖安装完成后，在项目根目录执行：
python app.py
如果启动成功，终端会显示类似信息：
Running on http://127.0.0.1:7860
八、访问与使用
打开浏览器
输入地址：
http://127.0.0.1:7860
进入可视化界面后即可：
上传照片
自动抠图
更换背景色
选择证件照尺寸
导出高清证件照
九、常见问题与解决方法
1. 启动时报错 torch / onnxruntime
确认 Python 版本是否正确
建议重新创建虚拟环境并安装依赖
2. 提示端口被占用
修改启动端口：
python app.py –port 7861
3. Windows 报 DLL 错误
安装最新版 Visual C++ 运行库
确保系统为 64 位
十、是否支持 GPU?
默认支持 CPU 运行
如果你有 NVIDIA 显卡，可自行安装 CUDA + 对应 PyTorch 版本
对新手来说，CPU 已完全够用
HiVisionIDPhotos 的安装流程并不复杂，核心步骤只有四点：
安装合适版本的 Python
克隆项目源码
创建虚拟环境并安装依赖
运行 app.py 并通过浏览器访问
完成本地部署后，你就拥有了一套完全私有、安全、高质量的证件照制作工具，非常适合个人、工作室或内网环境使用。
