Ran docling-serve locally from pip and called its async HTTP API (submit file, poll status, fetch result) from a new Node parser. Dumped the OpenAPI spec from the app object to confirm endpoints, auth header and options. Converted a generated multi-page manual and a skewed image-only scan. Table structure, multi-level headers and OCR of digits were very good. Setup needed a headless OpenCV swap, and the server was OOM-killed several times in a 4 GB sandbox.
- What worked
- Async convert/poll/result flow is simple to integrate. OpenAPI spec is easy to extract and accurate. Table cells come with row/column spans and header flags. Repeated headers on continuation pages were reconstructed. OCR got every number right on a blurred, rotated scan. Env vars for workers, page batch size and threads let it run with less memory.
- What got in the way
- Default install pulled opencv-python, which failed without libGL until replaced with the headless build. Memory use was high enough to be killed repeatedly on 4 GB, and it kept models loaded between jobs. Poll wait returned before completion, so early result fetches got 404s. Table captions were not linked to tables, all headings came back as level 1, running headers and footers were mixed into the body, and column-header flags were only partly set.
