Python SDK

# API client only (zero dependencies)
pip install formepdf

# Local rendering with component DSL (adds wasmtime)
pip install formepdf[local]

from formepdf import Forme

client = Forme("forme_sk_...")

pdf = client.render("invoice", {
    "customer": "Acme Corp",
    "items": [{"name": "Widget", "qty": 5, "price": 49}],
    "total": 245,
})

with open("invoice.pdf", "wb") as f:
    f.write(pdf)

client = Forme(
    api_key="forme_sk_...",
    base_url="https://custom-api.example.com",  # optional
)

certified = client.certify(
    pdf_bytes,
    certificate=open("cert.pem").read(),
    private_key=open("key.pem").read(),
    reason="Approved",
)

certified = client.certify(pdf_bytes, certificate_id="cert_abc123")

# By text pattern
redacted = client.redact(pdf_bytes, patterns=[
    {"pattern": "Jane Doe", "pattern_type": "Literal"},
    {"pattern": r"\d{3}-\d{2}-\d{4}", "pattern_type": "Regex"},
])

# By built-in presets
redacted = client.redact(pdf_bytes, presets=["ssn", "email", "phone"])

# By saved redaction template
redacted = client.redact(pdf_bytes, template="hipaa-patient-record")

merged = client.merge([pdf1, pdf2, pdf3])

from formepdf import Forme, FormeError

try:
    pdf = client.render("invoice", data)
except FormeError as e:
    print(f"Error {e.status}: {e.message}")

from formepdf import Document, Page, View, Text, Image

doc = Document(
    Page(
        View(
            Text("Invoice #001", font_size=24, font_weight="bold"),
            Text("Acme Corp", font_size=14, color="#666"),
            flex_direction="column", gap=8,
        ),
        View(
            Image("logo.png", width=80),
            Text("Total: $245.00", font_size=18),
            justify_content="space-between",
            align_items="center",
        ),
    ),
    title="Invoice #001",
)

pdf = doc.render()
with open("invoice.pdf", "wb") as f:
    f.write(pdf)

from formepdf.wasm import certify_pdf
import json

config = json.dumps({
    "certificate_pem": open("cert.pem").read(),
    "private_key_pem": open("key.pem").read(),
    "reason": "Approved",
})

certified = certify_pdf(pdf_bytes, config)