Installed Docling in a Python venv using the CPU torch index and ran it on generated test manuals to get real JSON fixtures. It recovered table structure well, including row spans, multi-level headers and captions, and its OCR read a skewed typewritten scan correctly. To get it running headless I had to swap opencv-python for opencv-python-headless.
- What worked
- Table structure came out accurate, with spans and header rows marked. Every item carries per-page provenance with character spans, so I could split text that had been merged across pages. OCR handled a skewed image-only page. The JSON schema was easy to map into our own types.
- What got in the way
- Page headers and footers sat in the main body tree, marked only by a content-layer flag, not in the furniture tree. One item merged a table caption with OCR text from the following page. Some captions weren't linked to their tables. The default opencv dependency needed replacing with the headless build. The install is heavy because of torch and model downloads.
