HivisionIDPhotos
Lightweight and efficient open-source AI ID photo generation and matting tool.
Generate standard ID and layout photos with local matting and face alignment.
HivisionIDPhotos is an open-source Python tool built for automated ID photo creation, matting, and sizing. It suits professional photographers and developers looking to integrate passport and ID generation workflows into local or web applications.
What it is
The software combines background matting models like MODNet, BiRefNet, and RMBG with face detection (MTCNN, RetinaFace, or Face++) to crop, resize, and alter ID photo backgrounds. It includes a Gradio interface supporting custom HEX background colors, beauty filters, print layouts, and 300DPI JPEG output.
Who it's for
It suits photographers and studios needing an automated pipeline for bulk ID photo processing or custom print layouts. It does not suit non-technical users who require a ready-to-use commercial desktop application without handling code, python environments, or Docker containers.
Key features
Lightweight Matting Models
Supports multiple offline background removal models including MODNet and BiRefNet.
Print Layout Tab
Generates 6-inch, 5-inch, A4, 3R, and 4R photo layout sheets with crop lines.
API & Docker Support
Deployable via FastAPI or Docker with options for beast mode memory caching.
Flexible Sizing and Color
Customise dimensions in millimeters and select background colors via CSV configs or HEX input.
Up and running in 3 steps
Our honest verdict
What's great
- Runs completely offline on CPU with lightweight matting models.
- Includes print layout options for standard sheet sizes with crop lines.
- Provides both a Gradio web demo and a FastAPI backend service.
- Supports custom background HEX inputs and face rotation alignment.
Where it falls short
- Requires technical skill to set up Python dependencies and download model weights.
- High-accuracy models like BiRefNet require significant RAM or a dedicated NVIDIA GPU.
- Online face detection options like Face++ require external API keys.
Pricing & license
Free under its open source license. The only cost is running it on your own hardware or server infrastructure.
Open remote AI-training roles
876 open remote AI-training roles, updated November 15, 2026; most pay $20–$170 an hour. Zekai lists them free; the application goes to the employer’s platform.
Alternatives
These reviewed AI tools do the same job instantly — from our scored directory.
Use it, or have us set it up
FAQ
Can I use this tool offline?
Yes, default models like MTCNN and MODNet run completely offline on your CPU without internet access.
How do I change standard ID dimensions?
You can modify the size_list_CN.csv file located in the demo assets folder to add or alter dimensions.
Can I accelerate processing with a GPU?
Yes, the BiRefNet model supports NVIDIA GPU acceleration if you install the corresponding ONNX Runtime GPU and CUDA drivers.
