HivisionIDPhotos
21,721
Stars
2,531
Forks
93
Watchers
106
Open Issues
Apache-2.0
许可证
Python
语言
2023-06-18
创建时间
2026-07-03
最近更新
项目能做什么
轻量且高效的 AI 证件照制作工具与算法。
来源：AI 基于仓库事实生成
· 内容以仓库实际 README 为准
使用说明 查看原始 README 原仓库文档
中文使用说明暂未生成。下面保留原仓库 README 摘录，命令与配置均以原文为准。
原始 README 摘录（英文原文，节选前 3000 字符）
<div align="center"> <img alt="hivision_logo" src="assets/hivision_logo.png" width=120 height=120> <h1>HivisionIDPhoto</h1> [English](README_EN.md) / 中文 / [日本語](README_JP.md) / [한국어](README_KO.md) [![][release-shield]][release-link] [![][dockerhub-shield]][dockerhub-link] [![][github-stars-shield]][github-stars-link] [![][github-issues-shield]][github-issues-link] [![][github-contributors-shield]][github-contributors-link] [![][github-forks-shield]][github-forks-link] [![][license-shield]][license-link] [![][wechat-shield]][wechat-link] [![][spaces-shield]][spaces-link] [![][swanhub-demo-shield]][swanhub-demo-link] [![][modelscope-shield]][modelscope-link] [![][modelers-shield]][modelers-link] [![][compshare-shield]][compshare-link] [![][atomgit-shield]][atomgit-link] [![][trendshift-shield]][trendshift-link] [![][hellogithub-shield]][hellogithub-link] <img src="assets/demoImage.jpg" width=900> </div> > **相关项目**： > > - [TRIO](https://pytrio.cn/home)：一个新型的AI计算平台（Tinker Like），让模型训练者无需维护复杂GPU基础设施，在个人电脑就可以轻松做llm sft/rl训练，训推均按token计费而非GPU时，支持弹性扩展，同时开20个实验不再困难。 <br> # 目录 - [最近更新](#-最近更新) - [项目简介](#-项目简介) - [社区](#-社区) - [准备工作](#-准备工作) - [Demo启动](#-运行-gradio-demo) - [Python推理](#-python-推理) - [API服务部署](#️-部署-api-服务) - [Docker部署](#-docker-部署) - [联系我们](#-联系我们) - [FAQ](#faq) - [感谢支持](#-感谢支持) - [License](#-lincese) - [引用](#-引用) <br> # 🤩 最近更新 - 在线体验： [](https://huggingface.co/spaces/TheEeeeLin/HivisionIDPhotos)、[![][modelscope-shield]][modelscope-link]、[![][modelers-shield]][modelers-link]、[![][compshare-shield]][compshare-link] - 2024.11.20: Gradio Demo增加**打印排版**选项卡，支持六寸、五寸、A4、3R、4R五种排版尺寸 - 2024.11.16: API接口增加美颜参数 - 2024.09.25: 增加**五寸相纸**和**JPEG下载**选项｜默认照片下载支持300DPI - 2024.09.24: API接口增加base64图像传入选项 | Gradio Demo增加**排版照裁剪线**功能 - 2024.09.22: Gradio Demo增加**野兽模式**，可设置内存加载策略 | API接口增加**dpi、face_alignment**参数 - 2024.09.18: Gradio Demo增加**分享模版照**功能、增加**美式证件照**背景选项 - 2024.09.17: Gradio Demo增加**自定义底色-HEX输入**功能 | **（社区贡献）C++版本** - [HivisionIDPhotos-cpp](https://github.com/zjkhahah/HivisionIDPhotos-cpp) 贡献 by [zjkhahah](https://github.com/zjkhahah) - 2024.09.16: Gradio Demo增加**人脸旋转对齐**功能，自定义尺寸输入支持**毫米**单位 <br> # 项目简介 > 🚀 谢谢你对我们的工作感兴趣。您可能还想查看我们在图像领域的其他成果，欢迎来信:zeyi.lin@swanhub.co. HivisionIDPhoto 旨在开发一种实用、系统性的证件照智能制作算法。 它利用一套完善的AI模型工作流程，实现对多种用户拍照场景的识别、抠图与证件照生成。 **HivisionIDPhoto 可以做到：** 1. 轻量级抠图（纯离线，仅需 **CPU** 即可快速推理） 2. 根据不同尺寸规格生成不同的标准证件照、六寸排版照 3. 支持 纯离线 或 端云 推理 4. 美颜 5. 智能换正装（waiting） <div align="center"> <img src="assets/demo.png" width=900> </div> --- 如果 HivisionIDPhoto 对你有帮助，请 star 这个 repo 或推荐给你的朋友，解决证件照应急制作问题！ <br> # 🏠 社区 我们分享了一些由社区构建的HivisionIDPhotos的有趣应用和扩展： | [HivisionIDPhotos-ComfyUI][community-hivision-comfyui] | [HivisionIDPhotos-wechat-weapp][community-hivision-wechat] | | :----------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------阅读完整原文
商业机会分析 AI 生成
多规格应急证件照微信小程序 / Web SaaS
| 产品构想 | 基于项目已有的FastAPI服务（支持base64传入、美颜、300DPI、人脸对齐及多种相纸排版）和社区开源的Uniapp/Web模板，快速上线面向应急拍照与出境/考试人群的在线证件照制作应用。 |
| 核心功能 | 手机端一键抠图换底（含自定义HEX及美式证件照背景）、自然美颜、自动旋转对齐、六寸/五寸/A4/3R/4R带裁剪线排版输出、300DPI JPEG下载。 |
| 目标用户 | 国内考生、求职者、签证办理人群及海外多语言用户（推测）。 |
| 难度/周期 | 低 · 2-4周（推测） · 成本：较低；因纯CPU即可快速离线推理且无复杂数据库依赖（db=0），初期仅需轻量服务器、存储及小程序认证费用（推测）。 |
| 收费模式 | 免费预览低清图，单次付费解锁300DPI高清照/排版照、次卡/包月会员、激励广告解锁或对接第三方冲印邮寄分成（推测）。 |
| 竞争风险 | 证件照小程序市场高度同质化、流量获取成本高；README标注“智能换正装”仍在waiting状态，缺乏换装能力可能影响高客单价转化；需做好人脸图像隐私存储与即时销毁合规。 |
| 依据 | 数据支持的判断 |
面向线下图文店与照相馆的纯离线桌面端软件
| 产品构想 | 利用项目纯CPU极速推理、支持内存加载策略（野兽模式）及5寸/6寸/A4带裁剪线打印排版的特性，结合社区C++版本或Docker本地封装为Windows/Mac桌面软件，解决门店断网隐私处理与快速出片需求。 |
| 核心功能 | 纯本地CPU离线运行、批量尺寸规格切换、一键生成带裁剪线300DPI印刷级排版图、自定义底色与轻度美颜。 |
| 目标用户 | 校园打印社、街边图文快印店、小型照相馆及证件现场采集点（推测）。 |
| 难度/周期 | 中 · 4-6周（推测） · 成本：极低；无需云端算力维护成本，主要为桌面GUI封装、本地授权校验及渠道推广时间投入（推测）。 |
| 收费模式 | 按终端设备买断授权（一机一码）或按年订阅收费，后续按需提供新规格库或增强插件升级包（推测）。 |
| 竞争风险 | 线下小微门店触达与地推成本较高；软件存在被破解盗版风险；专业照相馆对精修和换正装效果要求较高，当前版本“换正装”尚未完成。 |
| 依据 | 尚需验证的假设 |
企业级证件照合规处理托管API与私有化部署方案
| 产品构想 | 在现有FastAPI接口基础上补充用户鉴权、用量计费与高并发队列能力（弥补原仓库db=0的缺失），向HR SaaS、驾校、考试报名及政务系统提供免运维API或Docker内网私有化部署包。 |
| 核心功能 | 高可用RESTful API（支持base64、DPI、美颜、人脸对齐参数）、Docker弹性集群部署、API Key分发与调用统计、私有化内网部署支持。 |
| 目标用户 | 考试/招聘平台、学校及政企报名系统开发商、无AI运维能力的工具类应用团队（推测）。 |
| 难度/周期 | 中 · 3-6周（推测） · 成本：中等；需投入云服务器/弹性算力、API网关及监控运维成本（推测）。 |
| 收费模式 | API按调用量阶梯计费（次数包）、企业私有化部署年度授权费及定制化接口开发服务费（推测）。 |
| 竞争风险 | 项目采用Apache-2.0协议且已自带Docker与API部署代码，具备研发能力的客户可能直接自建替代；需靠高可用SLA、批量处理及补充合规检测功能建立付费壁垒。 |
| 依据 | AI推测 |
AI 基于仓库公开数据分析生成，含推测成分，不构成收益承诺。
报告会保存到 个人中心
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| fighting41love/funNLP | 中文介绍暂未生成 中英文敏感词、语言检测、中外手机/电话归属地/运营商查询、名字推断性别、手机号抽取、身份证抽取、邮箱抽取、中日文人名库、 |
84,528 | Python |
| microsoft/AI-For-Beginners | 中文介绍暂未生成 12 Weeks, 24 Lessons, AI for All! |
70,717 | Jupyter Notebook |
| JaidedAI/EasyOCR | 中文介绍暂未生成 Ready-to-use OCR with 80+ supported languages and all popula |
30,138 | Python |
| facebookresearch/Detectron | 中文介绍暂未生成 FAIR's research platform for object detection research, impl |
26,337 | Python |
| matterport/Mask_RCNN | 中文介绍暂未生成 Mask R-CNN for object detection and instance segmentation on |
25,576 | Python |
| bloc97/Anime4K | 中文介绍暂未生成 A High-Quality Real Time Upscaler for Anime Video |
21,628 | Jupyter Notebook |
以上为通过 GitHub 官方 Search API 检索的相似项目，功能差异与优劣势需进一步人工确认，配置 AI 后可生成对比分析。
项目优势与风险
| 技术成熟度 | 创建于 2023-06-18，最近推送 2026-07-03，发布过 17 个 Release |
| 社区活跃 | Star 21,721 / Fork 2,531 / Issue 106（数据支持，可自行核实） |
| 许可证 | Apache-2.0 |
| 主要风险 | 上游项目方向可能变化；同赛道竞争者较多（见竞品表）；热度与需求不完全等价 |
安装与使用
快速开始（以仓库 README 为准）
git clone https://github.com/Zeyi-Lin/HivisionIDPhotos.git cd HivisionIDPhotos # 请阅读仓库 README 获取确切安装步骤（依赖、配置、启动命令）
术语说明：Docker＝应用容器（把程序和依赖打包运行）；API Key＝调用外部服务的密钥；Git Clone＝把仓库代码下载到本地。常见错误：API Key 未配置 / 端口占用 / 数据库连接失败，多数项目在 README 的 Troubleshooting 章节有说明。