How 7drien/easyid works
EasyID turns a portrait supplied through the CLI, Python API, or desktop UI into a standards-sized, aligned identity photo, a compliance report, and optionally a print sheet. Its main processing path detects facial landmarks, segments the subject, crops and aligns the image, validates the result, and generates printable output. The README also documents webcam capture and image overlays. Some module relationships are visible only through the source index or README; the graph avoids inferring unshown calls.
Main entry points: pipeline.py Processing pipeline · main.py CLI launcher · config.py Photo standards · cropper.py Photo cropper
Components 17
User entry points
- CLI launcher
main.py - Desktop UI
easyid/ui/app.py - Python API
easyid/__init__.py
Face processing
- Processing pipeline
easyid/pipeline.py - Face landmarks
easyid/core/detector.py - Background segmentation
easyid/core/segmenter.py - Photo cropper
easyid/core/cropper.py - Face geometry
easyid/core/geometry.py
Standards and output
- Compliance checks
easyid/core/validator.py - Photo standards
easyid/config.py - Print sheet and export
easyid/printable.py
Model support
- Model cache
easyid/models.py
Other components
- User
- Portrait input
- Photo and report
easyid/pipeline.py - Model host
- Saved images
Connections 23
- User → CLI launcher: runs CLI
main.py - User → Desktop UI: opens UI
README.md - User → Python API: calls API
README.md - Portrait input → CLI launcher: supplies image
main.py - CLI launcher → Desktop UI: launches
main.py - CLI launcher → Processing pipeline: processes with
main.py - Desktop UI → Processing pipeline: processes with
easyid/ui/app.py - Python API → Processing pipeline: exposes
easyid/__init__.py - Processing pipeline → Face landmarks: detects face
easyid/pipeline.py - Processing pipeline → Background segmentation: extracts mask
easyid/pipeline.py - Processing pipeline → Photo cropper: crops image
easyid/pipeline.py - Photo cropper → Face geometry: computes transform
easyid/core/cropper.py - Processing pipeline → Compliance checks: validates image
easyid/pipeline.py - Processing pipeline → Print sheet and export: generates sheet
easyid/pipeline.py - Processing pipeline → Photo and report: returns
easyid/pipeline.py - Processing pipeline → Photo standards: uses standards
easyid/pipeline.py - Photo cropper → Photo standards: sets target dimensions
easyid/core/cropper.py - Compliance checks → Photo standards: checks thresholds
easyid/core/validator.py - Print sheet and export → Photo standards: uses sheet dimensions
easyid/printable.py - Face landmarks → Model cache: loads model
easyid/core/detector.py - Background segmentation → Model cache: loads model
easyid/core/segmenter.py - Model cache → Model host: downloads model
easyid/models.py - Photo and report → Saved images: saves images
easyid/pipeline.py