annotron 0.1.0

Annotron — French document parsing (Factur-X, KBis, RIB, paie, CERFA). Official Python SDK.

annotron — Python SDK

Official Python client for the Annotron API — French document parsing (Factur-X, KBis, RIB, paie, CERFA) returning typed, validated fields.

pip install annotron

Quickstart

from annotron import Annotron

client = Annotron(api_key="sk_live_...")

result = client.parse("facture.pdf")

print(result.siret)         # "12345678900012"   (Luhn-valide)
print(result.iban)          # "FR12 3456 7890…"  (mod-97-valide)
print(result.total_ttc)     # "1 234,56 €"
print(result.invoice_date)  # "12/03/2026"
print(result.dirigeants)    # ["Jean MARTIN", "Marie DURAND"]

For everything not exposed as a property, use result.items:

for it in result.items:
    print(it.type, it.content, it.confidence)

Configuration

The client reads from two environment variables if not passed explicitly:

export ANNOTRON_API_KEY=sk_live_...
export ANNOTRON_BASE_URL=https://api.annotron.com  # or your self-host

Self-hosting

On the Team plan you can run the worker yourself. Point the SDK at your endpoint:

client = Annotron(api_key="...", base_url="https://annotron.intra.acme.com")

Errors

from annotron import Annotron, AnnotronError

try:
    r = client.parse("malformed.pdf")
except AnnotronError as e:
    print(f"HTTP {e.status_code}: {e}")

Roadmap

• Synchronous client
• Async client (AnnotronAsync — issue welcome)
• Batch endpoint (client.parse_batch(files))
• Webhook signature verification helpers

PRs welcome. Apache-2.0.