ANNÁVE PDF Engine

A single Go binary that accepts documents in any common format via HTTP and returns a PDF. No headless browser. No JVM. No Python runtime. No cloud dependency. The entire conversion pipeline runs in-process: parse, validate, lay out, paginate, render.

annavetech/annave-pdf-engine-golang Open sourceApache 2.0

Getting Started

Quick Start

Run the ANNÁVE PDF Engine in under two minutes — build, start the server, and convert your first document.

Using the Engine

API & Integration

How to call the convert endpoint from Go, Node.js, Python, Swift, and Angular — with working code examples for each.

Error Codes

Full reference for all ENGINE_ERR_* codes: HTTP status, pipeline stage, when each code is triggered, and how to handle it in client code.

Configuration

Every configuration key across limits.yaml, style.yaml, server.yaml, and messages.yaml — with valid values, defaults, and what breaks at extremes.

CLI

PDF CLI

Convert documents to PDF from the command line — without starting an HTTP server.

Architecture

How It Works

Hexagonal architecture overview, six-stage pipeline, port interfaces, package structure, and instructions for adding a new parser.

Use Cases

Eight practical scenarios with working request examples and notes on edge cases. No marketing language — just what works and what to watch for.

White Paper

The problem, the design decisions, the tradeoffs, and the performance characteristics of the ANNÁVE PDF Engine v1.0.

Project

Contributing

How to add a parser, run tests, submit a pull request, and what code style is expected.

Dependencies

Every direct and indirect dependency, exact pinned version, what each does, and what breaks if you change the version.