HivisionIDPhotos：开源离线 AI 证件照工具，兼顾隐私与效率

从零上手：不同用户的使用指南

HivisionIDPhotos 做到了'新手友好，进阶有趣'，不同技术背景的用户都能找到适合自己的使用方式。

普通用户：零代码 Gradio 界面

无需编程基础，3 分钟即可搞定：

1. 下载模型：python scripts/download_model.py --models all（无法科学上网可手动从 Release 页面下载，放入指定目录）；
2. 启动 Web 界面：python app/web.py，访问 http://127.0.0.1:7860 即可上传照片、选择参数、生成证件照。

克隆仓库并搭建环境：

git clone https://github.com/Zeyi-Lin/HivisionIDPhotos.git
cd HivisionIDPhotos
conda create -n hivision python=3.10
conda activate hivision
pip install -r requirements.txt -r requirements-app.txt

懒人必备：Docker 一键部署

无需配置依赖，一条命令即可启动服务：

docker run -d -p 7860:7860 linzeyi/hivision_idphotos

开发者/企业：API 集成与批量处理

通过 FastAPI 提供的接口，可快速集成到现有系统。例如企业 HR 批量处理员工照片：

import requests
import base64

def process_employee_photos(api_url, image_data, background_color=(255, 255, 255)):
    # 调用 API 生成证件照
    idphoto_response = requests.post(
        f"{api_url}/idphoto", 
        files={"file": image_data}, 
        data={"size": "(413,295)"} # 一寸照片规格
    )
    if idphoto_response.status_code == 200:
        # 添加白色背景
        add_bg_response = requests.post(
            f"{api_url}/add_background", 
            files={"file": idphoto_response.content}, 
            data={"color": str(background_color)}
        )
        return add_bg_response.content
    return None

对比同类工具

在证件照工具赛道，HivisionIDPhotos 的开源属性和离线能力形成了独特竞争力，我们通过对比看看它的优势：

总结与展望

HivisionIDPhotos 的走红，本质上是击中了用户对'高效、隐私、免费'证件照工具的核心需求。它没有复杂的功能堆砌，却将每一个核心环节做到了极致——轻量的模型让老旧设备也能流畅运行，模块化设计让开发者能自由发挥，纯离线运行守住了隐私底线。

目前项目仍在高频迭代，智能换装、高级美颜等功能已列入开发计划，社区贡献也日益活跃，从 C++ 版本到微信小程序，不断丰富着应用场景。对于普通用户，它是应急必备的证件照神器；对于开发者，它是入门 AI 图像处理、二次开发的优质范本。

项目托管于 GitHub，欢迎开发者参与贡献与二次开发。