Skip to main content

AcroMELD

Turns a flat PDF into a fillable form. Give it a PDF that looks like a form but has no form fields, and it finds every field and writes a real, clickable AcroForm.

acromeld input.pdf output.pdf

The first run downloads the model (158 MB) from Hugging Face and caches it. CPU is the default and works fine; a page takes a few seconds.

From Python:

from acromeld import prepare_form

prepare_form("input.pdf", "output.pdf")

Options

Argument Default Description
--weights download use a local weights file instead of the Hub
--device cpu torch device, e.g. cuda
--confidence TEXT CHOICE SIGNATURE calibrated override the per-class thresholds
--keep-existing-fields off keep form fields the PDF already has
--use-signature-fields off write real signature widgets
--multiline off allow multiline input in text fields

What it detects

Three field types — Text, Choice, Signature — plus a learned link that merges several visual candidates into one field instead of emitting duplicates. It reads two channels at once: the rendered page, and the PDF's own drawing primitives, which a purely visual detector ignores. 39.4M parameters, up to 896 fields per page.

How well it works

Measured once on a sealed holdout of 1,996 PDFs / 6,843 pages the model never saw during training, against a threshold registered before training started: containment micro-F1 0.84767 against a required 0.82904 — passed.

Read this before using it:

  • Signature detection does not work. At the calibrated threshold the model predicts essentially no signature fields. Text and Choice carry the entire score.
  • Under a stricter IoU/COCO adapter the same model reaches only 0.28996 mAP, below a locally evaluated CommonForms-L reference.
  • Measured on German-language forms. Other languages and layouts are untested.
  • Rotated pages are rejected rather than silently misplaced.
  • One sealed run, one seed. No stability claim.

This is a research artifact, not a product.

Licence

Apache-2.0. Vendored third-party components and their modifications are listed in THIRD-PARTY-NOTICES.md in the source distribution.

Metadata

Release files for acromeld 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for acromeld 0.1.0
File Size Uploaded Provenance
acromeld-0.1.0.tar.gz 528.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for acromeld 0.1.0
File Interpreter ABI Platform
acromeld-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 759.9 kB

Release files / acromeld-0.1.0.tar.gz

Download URL acromeld-0.1.0.tar.gz
Size 528.3 kB
Tags Source
SHA-256 checksum
How to use checksums
51969b96cb0eda5370b5babb240a3e256bcc9b052711c08acb590c736dc985b3
BLAKE2b-256 checksum
How to use checksums
a70ef638c5986509e6752b314b5a80298a3a34510df980f697536f5986113267
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / acromeld-0.1.0-py3-none-any.whl

Download URL acromeld-0.1.0-py3-none-any.whl
Size 231.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7185ed32aea00fc28dd1d12c4a71730c7223191dce4d629360acf784c490e084
BLAKE2b-256 checksum
How to use checksums
d1bac34d9e8218d5d49ef1492ad6b35d546c1d689d6eb1c2b612ffe5851d559f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for acromeld 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page