# Penquify

## Docs

- [Agent Testing](https://docs.penquify.com/agent-testing.md): End-to-end testing for document-processing agents: generate docs, feed to agent, verify actions.
- [POST /generate/config](https://docs.penquify.com/api/generate-config.md): Convert natural language to a PhotoVariation JSON config.
- [POST /generate/dataset](https://docs.penquify.com/api/generate-dataset.md): Full pipeline: document JSON to PDF to photo variations in one call.
- [POST /generate/document](https://docs.penquify.com/api/generate-document.md): Generate a PDF and PNG document from structured JSON data.
- [POST /generate/from-upload](https://docs.penquify.com/api/generate-from-upload.md): Upload a PDF or image, auto-detect schema, and generate verified photo variations.
- [POST /generate/photos](https://docs.penquify.com/api/generate-photos.md): Generate realistic smartphone photos from an existing document image.
- [GET /documents](https://docs.penquify.com/api/list-documents.md): List all generated document runs and download files.
- [API Overview](https://docs.penquify.com/api/overview.md): FastAPI REST server for document and photo generation.
- [GET /presets & /templates](https://docs.penquify.com/api/presets.md): List available photo variation presets and document templates.
- [Core Concepts](https://docs.penquify.com/concepts.md): The four pillars of penquify: Document model, Photo variations, Ground truth verification, Occlusion manifest.
- [Create Datasets](https://docs.penquify.com/create-dataset.md): Batch generation: N documents x M variations, with verification and occlusion manifests.
- [Custom Templates](https://docs.penquify.com/custom-template.md): Create new document templates with Jinja2 HTML.
- [Documents](https://docs.penquify.com/documents.md): The Document model: DocHeader, DocItem, templates, and JSON schema.
- [Generate from JSON](https://docs.penquify.com/generate-from-json.md): Create a document from structured JSON data and generate PDF, PNG, and photo variations.
- [Agent SDK Plugin](https://docs.penquify.com/integrations/agent-sdk.md): Add penquify tools to Claude Agent SDK applications.
- [CLI Reference](https://docs.penquify.com/integrations/cli.md): Full command-line interface reference for penquify.
- [Docker](https://docs.penquify.com/integrations/docker.md): Run penquify in Docker with the REST API server.
- [MCP Server](https://docs.penquify.com/integrations/mcp-server.md): Connect penquify to Claude Desktop, Cursor, or Windsurf via MCP.
- [Python Library](https://docs.penquify.com/integrations/python.md): Use penquify as a Python library in your own code.
- [Introduction](https://docs.penquify.com/introduction.md): OCR in reverse. Structured data in, realistic document photo out — with verified ground truth.
- [Natural Language Config](https://docs.penquify.com/natural-language-config.md): Describe photo variations in plain English and let Gemini generate the JSON config.
- [Occlusion Manifest](https://docs.penquify.com/occlusion-manifest.md): Field-level visibility tracking: what's visible, what's hidden, and why.
- [OCR Benchmarking](https://docs.penquify.com/ocr-benchmark.md): Generate controlled datasets to benchmark OCR and document extraction models.
- [Quickstart](https://docs.penquify.com/quickstart.md): Install penquify and generate your first synthetic document photos in under 5 minutes.
- [Camera Presets](https://docs.penquify.com/sdk/cameras.md): SDK reference for the 22 camera presets.
- [Document Classes](https://docs.penquify.com/sdk/document.md): SDK reference for Document, DocHeader, and DocItem.
- [Generators](https://docs.penquify.com/sdk/generators.md): SDK reference for document and photo generation functions.
- [Upload Functions](https://docs.penquify.com/sdk/upload.md): SDK reference for PDF upload, schema detection, and the upload pipeline.
- [PhotoVariation & Stain](https://docs.penquify.com/sdk/variation.md): SDK reference for PhotoVariation and Stain dataclasses.
- [Verification Functions](https://docs.penquify.com/sdk/verify.md): SDK reference for extraction, comparison, and occlusion manifest building.
- [Upload PDF](https://docs.penquify.com/upload-pdf.md): Upload an existing PDF or image, auto-detect its schema, and generate photo variations.
- [Photo Variations](https://docs.penquify.com/variations.md): Configure every aspect of generated photos: camera, angle, blur, stains, folds, and more.
- [Verification](https://docs.penquify.com/verification.md): Blind extraction, programmatic comparison, retry loop -- how penquify ensures photo accuracy.

## OpenAPI Specs

- [openapi](https://docs.penquify.com/api-reference/openapi.json)