invoice-tool

Fully-offline Python CLI that generates a sendable USD PDF invoice from local TOML files. No Odoo, no Google Drive, no network — the same inputs always produce a byte-identical PDF.

Install

pip install invoice-tool

Requires Python >= 3.13. The DejaVu/Liberation fonts the renderer embeds ship inside the wheel, so no system fonts are required.

Quickstart

# Verify the install
invoice-tool version

# Generate the latest invoice for a customer from a data directory
invoice-tool generate arsenale --data-dir ./sample-data

generate <customer> reads three TOML sources (issuer, customer, invoice), composes and validates one invoice, renders a deterministic A4 PDF with embedded fonts, and writes it next to its source data as DblFuzzr Inv <Customer> N<seq>.pdf. The output path is printed to stdout, so it composes in a pipeline; diagnostics go to stderr.

See invoice-tool generate --help for all options (--invoice, --out, --data-dir, --config).

Documentation

SKILL.md is the full operator/agent guide: data-directory layout and schema, font configuration (bundled / system / dejavu modes), the worked generate example, scriptable exit codes, and the determinism & offline guarantee.