hivision-idphotos

Automate ID photo matting, background replacement, cropping, and layout generation.

7|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/wsxwj123/opencode-skills-backup --skill hivision-idphotos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hivision-idphotos
Source: https://github.com/wsxwj123/opencode-skills-backup/tree/main/hivision-idphotos
Command: npx skills add https://github.com/wsxwj123/opencode-skills-backup --skill hivision-idphotos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, opencv-python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

ID photo production often requires multiple tools and manual steps to mat, crop, background, and layout. This skill automates the entire end-to-end workflow using the HivisionIDPhotos framework, delivering ready-to-use ID photos.

Core Features & Use Cases

  • End-to-end ID photo pipeline: matting, background replacement, cropping to standard sizes, and print-layout generation.
  • Local CLI orchestration: a single wrapper script coordinates all steps with configurable inputs.
  • Use cases include passport photos, visa photos, and other standardized ID photos with consistent output dimensions.

Quick Start

Run the wrapper to process an input portrait through matting, background replacement, and layout generation using default ID photo sizes.

Frequently Asked Questions about hivision-idphotos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate ID photo matting, background replacement, and cropping in one workflow?

You can automate the entire ID photo workflow by running the provided CLI wrapper, which coordinates matting, background replacement, precise cropping, and print-layout generation in a single pipeline.

What is the best way to generate standard passport and visa photo layouts locally?

The best way to generate standard passport and visa photo layouts locally is using a CLI wrapper that orchestrates the HivisionIDPhotos framework to process raw portraits into ready-to-print layouts.

Do I need OpenCV and NumPy installed to process ID photos with this CLI?

Yes, you need Python with OpenCV and NumPy installed, along with the local HivisionIDPhotos repository, to execute the CLI wrapper for ID photo matting and layout generation.

Can I use this ID photo pipeline for standardized portraits other than passports?

Yes, you can use this pipeline for any standardized ID photos and portraits, as it applies configurable matting, background replacement, cropping, and layout generation to various output dimensions.

How does automated portrait matting work for ID photo background replacement?

Automated portrait matting works by isolating the subject from the original background using the HivisionIDPhotos framework, allowing the CLI wrapper to apply a new background and crop the result to standard ID photo dimensions.