Skip to main content

​
Usage

penquify <command> [options]

​
Commands

​
demo

Generate a complete demo dispatch guide with photo variations. 
penquify demo [--output DIR] [--presets PRESET...]
FlagDefaultDescription
--output, -ooutputOutput directory
--presetsall 8 presetsSpace-separated preset names
Generates a 7-item dispatch guide from ACME data, renders to HTML/PNG/PDF, then generates photo variations. 
# Full demo with all presets
penquify demo

# Demo with specific presets
penquify demo --presets full_picture blurry coffee_stain

# Demo to custom directory
penquify demo --output my-demo/

​
pdf

Generate PDF/PNG from a document JSON file (no photo generation). 
penquify pdf [--doc-json FILE] [--output DIR]
FlagDefaultDescription
--doc-json(uses demo doc)Path to document JSON file
--output, -ooutputOutput directory
# From JSON file
penquify pdf --doc-json my-document.json --output docs/

# Demo document only (no photos)
penquify pdf

​
photos

Generate photo variations from an existing PNG image. 
penquify photos --image FILE [--output DIR] [--presets PRESET...]
FlagDefaultDescription
--image(required)Path to source document image (PNG)
--output, -ooutputOutput directory
--presetsall 8 presetsSpace-separated preset names
# Generate all presets
penquify photos --image output/guia_despacho_00054321.png

# Specific presets
penquify photos --image doc.png --presets full_picture blurry --output photos/

​
upload

Upload a PDF or image, detect schema, and generate verified photo variations. 
penquify upload --image FILE [--output DIR] [--presets PRESET...]
FlagDefaultDescription
--image(required)Path to PDF or image file
--output, -ooutputOutput directory
--presetsfull_picture, folded_skewed, blurrySpace-separated preset names
# Upload a PDF
penquify upload --image invoice.pdf --output uploaded/

# Upload with custom presets
penquify upload --image receipt.jpg --presets full_picture coffee_stain

​
Available Presets

NameDescription
full_pictureClean photo, 90% coverage, slight angle
folded_skewedDog ear folds, strong curvature, moderate skew
zoomed_detail95% coverage, tight crop
blurryMotion blur, overall soft focus
cropped_headerTop 10-15% cut off
strong_oblique45 degree angle, strong skew
coffee_stainCoffee stain with partial text obstruction
stapled_stackStapled with sheets behind

​
Environment Variables

VariableDescription
GEMINI_API_KEYRequired for photo generation and verification
PENQUIFY_OUTPUTDefault output directory (overridden by --output)