Quickstart

Prerequisites

Python 3.10+
A Gemini API key (for photo generation and verification)

Installation

pip install penquify

pip install penquify[api,mcp]

Install Playwright browsers (required for PDF/PNG rendering):

playwright install chromium

Set Your API Key

export GEMINI_API_KEY=your-gemini-api-key

Run the Demo

penquify demo

This will:

Generate a demo dispatch guide (guia de despacho) with 7 line items
Render it to HTML, PNG, and PDF in output/
Generate 8 photo variations (full picture, folded, blurry, cropped, stained, etc.)

Output structure:

output/
  guia_despacho_01182034.html
  guia_despacho_01182034.png
  guia_despacho_01182034.pdf
  photos/
    photo_full_picture.png
    photo_folded_skewed.png
    photo_zoomed_detail.png
    photo_blurry.png
    photo_cropped_header.png
    photo_strong_oblique.png
    photo_coffee_stain.png
    photo_stapled_stack.png

Generate from Your Own Data

Create a doc.json file:

{
  "header": {
    "doc_type": "guia_despacho",
    "doc_number": "00054321",
    "date": "15/04/2026",
    "emitter_name": "ACME FOODS S.A.",
    "emitter_rut": "76.123.456-7",
    "receiver_name": "DISTRIBUIDORA CENTRAL LTDA.",
    "receiver_rut": "77.987.654-3",
    "oc_number": "4500001234"
  },
  "items": [
    {
      "pos": 1,
      "code": "AF-1001",
      "description": "HARINA DE TRIGO PREMIUM 25KG",
      "qty": 40,
      "unit": "UN",
      "unit_price": 12500,
      "total": 500000
    },
    {
      "pos": 2,
      "code": "AF-2003",
      "description": "ACEITE VEGETAL 5L",
      "qty": 24,
      "unit": "UN",
      "unit_price": 6990,
      "total": 167760
    }
  ],
  "observations": "2 pallets. Harina: lote 2026-03."
}

Generate the PDF:

penquify pdf --doc-json doc.json --output my-output/

Generate photos from any image:

penquify photos --image my-output/guia_despacho_00054321.png --presets full_picture blurry coffee_stain

Next Steps

Core Concepts

Understand the document model, photo variations, and verification pipeline.

API Reference

Use the REST API for programmatic access.

MCP Server

Connect penquify to Claude Desktop or Cursor.

Create Datasets

Generate benchmark datasets at scale.

Getting Started

Core Concepts

Guides

Prerequisites

Installation

Set Your API Key

Run the Demo

Generate from Your Own Data

Next Steps

Core Concepts

API Reference

MCP Server

Create Datasets

​Prerequisites

​Installation

​Set Your API Key

​Run the Demo

​Generate from Your Own Data

​Next Steps

Core Concepts

API Reference

MCP Server

Create Datasets

Prerequisites

Installation

Set Your API Key

Run the Demo

Generate from Your Own Data

Next Steps