Simple package to extract text with coordinates from programmatic PDFs

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

These details have not been verified by PyPI

Project description

Docling Parse

Simple package to extract text, paths and bitmap images with coordinates from programmatic PDFs. This package is used in the Docling PDF conversion. Below, we show a few output of the latest parser with char, word and line level output for text, in addition to the extracted paths and bitmap resources.

To do the visualizations yourself, simply run (change word into char or line),

uv run python ./docling_parse/visualize.py -i <path-to-pdf-file> -c word --interactive

original	char	word	line

Quick start

Install the package from Pypi

pip install docling-parse

Convert a PDF (look in the visualize.py for a more detailed information)

from docling_core.types.doc.page import TextCellUnit
from docling_parse.pdf_parser import DoclingPdfParser, PdfDocument

parser = DoclingPdfParser()

pdf_doc: PdfDocument = parser.load(
    path_or_stream="<path-to-pdf>"
)

# PdfDocument.iterate_pages() will automatically populate pages as they are yielded.
for page_no, pred_page in pdf_doc.iterate_pages():

    # iterate over the word-cells
    for word in pred_page.iterate_cells(unit_type=TextCellUnit.WORD):
        print(word.rect, ": ", word.text)

        # create a PIL image with the char cells
    img = pred_page.render_as_image(cell_unit=TextCellUnit.CHAR)
    img.show()

Use the CLI

$ docling-parse -h
usage: docling-parse [-h] -p PDF

Process a PDF file.

options:
  -h, --help         show this help message and exit
  -p PDF, --pdf PDF  Path to the PDF file

Performance Benchmarks

Characteristics of different parser versions

Version	Original	Word-level	Snippet-level	Performance
V1		Not Supported		~0.250 sec/page
V2				~0.050 sec/page [~5-10X faster than v1]

Timings of different parser versions

We ran the v1 and v2 parser on DocLayNet. We found the following overall behavior

parser-performance

Development

CXX

To build the parse, simply run the following command in the root folder,

rm -rf build; cmake -B ./build; cd build; make

You can run the parser from your build folder. Example from parse_v1,

% ./parse_v1.exe -h
A program to process PDF files or configuration files
Usage:
  PDFProcessor [OPTION...]

  -i, --input arg          Input PDF file
  -c, --config arg         Config file
      --create-config arg  Create config file
  -o, --output arg         Output file
  -l, --loglevel arg       loglevel [error;warning;success;info]
  -h, --help               Print usage

Example from parse_v2,

% ./parse_v2.exe -h
program to process PDF files or configuration files
Usage:
  PDFProcessor [OPTION...]

  -i, --input arg          Input PDF file
  -c, --config arg         Config file
      --create-config arg  Create config file
  -p, --page arg           Pages to process (default: -1 for all) (default:
                           -1)
  -o, --output arg         Output file
  -l, --loglevel arg       loglevel [error;warning;success;info]
  -h, --help               Print usage

If you dont have an input file, then a template input file will be printed on the terminal.

Python

To build the package, simply run (make sure uv is installed),

uv sync

The latter will only work after a clean git clone. If you are developing and updating C++ code, please use,

# uv pip install --force-reinstall --no-deps -e .
rm -rf .venv; uv venv; uv pip install --force-reinstall --no-deps -e ".[perf-tools]"

To test the package, run:

uv run pytest ./tests -v -s

Contributing

Please read Contributing to Docling Parse for details.

References

If you use Docling in your projects, please consider citing the following:

@techreport{Docling,
  author = {Deep Search Team},
  month = {8},
  title = {Docling Technical Report},
  url = {https://arxiv.org/abs/2408.09869},
  eprint = {2408.09869},
  doi = {10.48550/arXiv.2408.09869},
  version = {1.0.0},
  year = {2024}
}

License

The Docling Parse codebase is under MIT license. For individual model usage, please refer to the model licenses found in the original packages.

Project details

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

ibm-deepsearch-core

These details have not been verified by PyPI

Release history Release notifications | RSS feed

This version

4.5.0

Sep 17, 2025

4.4.0

Sep 4, 2025

4.3.0 yanked

Sep 3, 2025

Reason this release was yanked:

Defects in parsing

4.2.3

Aug 22, 2025

4.2.2

Aug 19, 2025

4.2.1

Aug 19, 2025

4.2.0

Aug 19, 2025

4.1.0

Jun 24, 2025

4.0.5

Jun 13, 2025

4.0.4

Jun 10, 2025

4.0.3

Jun 5, 2025

4.0.2

Jun 4, 2025

4.0.1

Apr 9, 2025

4.0.0

Mar 14, 2025

3.4.0

Feb 18, 2025

3.3.1

Feb 13, 2025

3.3.0

Feb 6, 2025

3.2.0

Feb 2, 2025

3.1.2

Jan 27, 2025

3.1.1

Jan 21, 2025

3.1.0

Jan 17, 2025

3.0.0

Dec 9, 2024

2.1.2

Nov 22, 2024

2.1.0

Nov 20, 2024

2.0.5

Nov 20, 2024

2.0.4

Nov 13, 2024

2.0.3

Nov 5, 2024

2.0.2

Oct 30, 2024

2.0.1

Oct 25, 2024

2.0.0

Oct 23, 2024

1.6.2

Oct 18, 2024

1.6.1

Oct 18, 2024

1.6.0

Oct 11, 2024

1.5.1

Oct 10, 2024

1.4.1

Oct 2, 2024

1.3.1 yanked

Sep 30, 2024

1.3.0

Sep 20, 2024

1.2.1

Sep 18, 2024

1.2.0

Sep 9, 2024

1.1.3

Aug 30, 2024

1.0.0

Aug 22, 2024

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

docling_parse-4.5.0.tar.gz (66.4 MB view details)

Uploaded Sep 17, 2025 Source

Built Distributions

docling_parse-4.5.0-pp311-pypy311_pp73-win_amd64.whl (17.9 MB view details)

Uploaded Sep 17, 2025 PyPyWindows x86-64

docling_parse-4.5.0-pp310-pypy310_pp73-win_amd64.whl (17.9 MB view details)

Uploaded Sep 17, 2025 PyPyWindows x86-64

docling_parse-4.5.0-pp39-pypy39_pp73-win_amd64.whl (17.9 MB view details)

Uploaded Sep 17, 2025 PyPyWindows x86-64

docling_parse-4.5.0-cp313-cp313-win_amd64.whl (16.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.13Windows x86-64

docling_parse-4.5.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (15.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.13manylinux: glibc 2.17+ x86-64

docling_parse-4.5.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (15.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.13manylinux: glibc 2.17+ ARM64

docling_parse-4.5.0-cp313-cp313-macosx_14_0_arm64.whl (14.6 MB view details)

Uploaded Sep 17, 2025 CPython 3.13macOS 14.0+ ARM64

docling_parse-4.5.0-cp313-cp313-macosx_13_0_x86_64.whl (14.7 MB view details)

Uploaded Sep 17, 2025 CPython 3.13macOS 13.0+ x86-64

docling_parse-4.5.0-cp312-cp312-win_amd64.whl (16.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.12Windows x86-64

docling_parse-4.5.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (15.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.12manylinux: glibc 2.17+ x86-64

docling_parse-4.5.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (15.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.12manylinux: glibc 2.17+ ARM64

docling_parse-4.5.0-cp312-cp312-macosx_14_0_arm64.whl (14.6 MB view details)

Uploaded Sep 17, 2025 CPython 3.12macOS 14.0+ ARM64

docling_parse-4.5.0-cp312-cp312-macosx_13_0_x86_64.whl (14.7 MB view details)

Uploaded Sep 17, 2025 CPython 3.12macOS 13.0+ x86-64

docling_parse-4.5.0-cp311-cp311-win_amd64.whl (16.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.11Windows x86-64

docling_parse-4.5.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (15.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.11manylinux: glibc 2.17+ x86-64

docling_parse-4.5.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (15.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.11manylinux: glibc 2.17+ ARM64

docling_parse-4.5.0-cp311-cp311-macosx_14_0_arm64.whl (14.6 MB view details)

Uploaded Sep 17, 2025 CPython 3.11macOS 14.0+ ARM64

docling_parse-4.5.0-cp311-cp311-macosx_13_0_x86_64.whl (14.7 MB view details)

Uploaded Sep 17, 2025 CPython 3.11macOS 13.0+ x86-64

docling_parse-4.5.0-cp310-cp310-win_amd64.whl (16.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.10Windows x86-64

docling_parse-4.5.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (15.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.10manylinux: glibc 2.17+ x86-64

docling_parse-4.5.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (15.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.10manylinux: glibc 2.17+ ARM64

docling_parse-4.5.0-cp310-cp310-macosx_14_0_arm64.whl (14.6 MB view details)

Uploaded Sep 17, 2025 CPython 3.10macOS 14.0+ ARM64

docling_parse-4.5.0-cp310-cp310-macosx_13_0_x86_64.whl (14.7 MB view details)

Uploaded Sep 17, 2025 CPython 3.10macOS 13.0+ x86-64

docling_parse-4.5.0-cp39-cp39-win_amd64.whl (16.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.9Windows x86-64

docling_parse-4.5.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (15.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.9manylinux: glibc 2.17+ x86-64

docling_parse-4.5.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (15.1 MB view details)

Uploaded Sep 17, 2025 CPython 3.9manylinux: glibc 2.17+ ARM64

docling_parse-4.5.0-cp39-cp39-macosx_14_0_arm64.whl (14.6 MB view details)

Uploaded Sep 17, 2025 CPython 3.9macOS 14.0+ ARM64

docling_parse-4.5.0-cp39-cp39-macosx_13_0_x86_64.whl (14.7 MB view details)

Uploaded Sep 17, 2025 CPython 3.9macOS 13.0+ x86-64

File details

Details for the file docling_parse-4.5.0.tar.gz.

File metadata

Download URL: docling_parse-4.5.0.tar.gz
Upload date: Sep 17, 2025
Size: 66.4 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for docling_parse-4.5.0.tar.gz
Algorithm	Hash digest
SHA256	`e78f648c3a8af5ddb7dcc30c6c4270e9d3257366396a020ad60657de98bf88f5`
MD5	`7ba1d02681834a3a1d2b54e14246b405`
BLAKE2b-256	`a36671ee4d1c9d85257aebe3efbf975a94265f1abcc3cd297549f5429b20e067`

Algorithm	Hash digest
SHA256	`9d02c43d3185f5f4a6d5aaad38e69e07bbd1f965fd62f331bd9dfc006a637604`
MD5	`b281679f22e3d6db122a694f0841fd2b`
BLAKE2b-256	`a66449b8f6c2599d1113cbd55a698629131aeca6ec6c98bff497115fc7e08af7`

Algorithm	Hash digest
SHA256	`f983d65703a165b76775c3e4b2a5cade4757216eb88faf5c0c86a9b33f38549a`
MD5	`24e95944313324872f01b2274a6c30de`
BLAKE2b-256	`258d03ca17507b5a1441a63ef0ac4d67f24430efddf0e923d365c837ebac37e6`

Algorithm	Hash digest
SHA256	`9bf94bc213bedd6d880d94eface2285e9e344da5452a23b3a8d0fedecb5d3ec1`
MD5	`5a9448f99f5c447fb1b7f100b9f6ce95`
BLAKE2b-256	`72f28b83cb1e7272a822cd34acc0741ea8246c3490d7ebac5f0b5c22e9eeee69`

Algorithm	Hash digest
SHA256	`c3dba06a3cb8797587c90f5aa10cc2c51803d8f5cd67342ea948288a30503868`
MD5	`ec1a7355c7561ae54b87f3dbe21ade8a`
BLAKE2b-256	`4702b7e2fd3cb58db9064ff69ba52ba40b1716f527f023c8b63b26e5eb4c04dc`

Algorithm	Hash digest
SHA256	`24360a0985a8f76ff99c39e533d208bb57427caf96b9ceb585090cd10558f87a`
MD5	`30408551d548ead00b7e341f38d60156`
BLAKE2b-256	`afc0eb9fd89d518bea24566e9effc048c09c2583722a463d00aafdbe48c8e729`

Algorithm	Hash digest
SHA256	`b7c9e8954118331438eb8da6058da0e3caf12735b47a86af9521e44465bbb2d4`
MD5	`ddde2dd6e7a5e44c2ddd5f1b929d2607`
BLAKE2b-256	`e329e4a9d44987039b0e02106b0c073832b00a6592e4a7bdde3b17b439443a75`

Algorithm	Hash digest
SHA256	`368ebdb22ec03aa29b25d2684e51c74f6e167ab6809cd7bb5bb5b97cfe21bf8c`
MD5	`a47148957b094c5625e99a5ff6245cf2`
BLAKE2b-256	`16468e35c50b8cb18d175ec62621c5bbf36b410359431bc9ae2fef6a47bb79ff`

Algorithm	Hash digest
SHA256	`d8b2a25262a09e956516c4439ae143a66a55212f0ef9945928159caf1346408f`
MD5	`94427d0d5c2e7f4236159fed2c4fa46c`
BLAKE2b-256	`0a105e6b37cbba638f8ddf53eea9a943c40f39073ca74e0a4e4793517cfe8cc0`

Algorithm	Hash digest
SHA256	`5688fe4281dac16e807496c0b19587e25c53a9542d12f36b3a8fb2e66de78eb2`
MD5	`c4c7de5e51cb8569f6f4e596772dfebb`
BLAKE2b-256	`dfc6bdfd07be28e4f24aa46a67aca193c441d8ce322332fe8f0df929c5b17326`

Algorithm	Hash digest
SHA256	`d84186662e4780375de28b1bcb18112b04bd8e6aedb787d96544cc0d687f9629`
MD5	`a8bd3cb231698d29bba55a88bed2ccf1`
BLAKE2b-256	`96516636f121e190fcd7fae81c5060e96fe55e1a34370b37f4cf4274acd99cf1`

Algorithm	Hash digest
SHA256	`4c8906d076219a18f4f86b1fec4e4cc3699460e78c88a5731ead48dfbb71835a`
MD5	`c5794da8c2a98d3464000b1db6eeff86`
BLAKE2b-256	`6717e6dcdb384ce91679be0135cfd55d243b64f7dbff4ad55aaf1402a2d6b8d3`

Algorithm	Hash digest
SHA256	`a5f0bcdd6c84acc3f3a4c1f0fb96be7e9cff7a0bdff85f2f13caa80d2a9fac8f`
MD5	`8d569c74f15c8a6f34fb67d312eef2f6`
BLAKE2b-256	`e69c364d03433c8fc4d90b93cf9413531278d11cb9ba0e64b49971bc41101c2c`

Algorithm	Hash digest
SHA256	`d0ea05741721a76cfca6559d7cac283f2b2953915745b439be0ca8557864bb33`
MD5	`114ae2648d6ab343853d4756ff25a364`
BLAKE2b-256	`6e05295bb2d68726e3cc78df0bed8ad710cd766e17c9ae5a497f0eb25bc49c5a`

Algorithm	Hash digest
SHA256	`256019969f1edc08b051a90fe739430593aaf7cd59fb18a2e00745f18533ce43`
MD5	`896799552912f66d5c069d97283142b7`
BLAKE2b-256	`25e37bb95eb02c212b77adae9acff4ec164ab29449186e110404611d8c436e57`

Algorithm	Hash digest
SHA256	`c49193988b56133149584fed70b176de85c95fe698849b2acf68fde9df3a93e5`
MD5	`1a02cd04e236dce02dfeb78f0d4d81ce`
BLAKE2b-256	`f40405d389bb8aff34e61b7136f1191faeb6b51c642a4f1e3d1ad3c25c540eb1`

Algorithm	Hash digest
SHA256	`ee02646e7a158c9f67d8df0052b544f1240d3c28eefa4658603931c13eac4435`
MD5	`2831ff8caee152169b131f0f374075e1`
BLAKE2b-256	`8e5ba2c8b06730607639feb04c64ae4ac1a4dbc5aa5886730d8fb57c5421de2c`

Algorithm	Hash digest
SHA256	`0a1a5f3e2f11ea74ab28d9c04b9391fa4b929c4af045c16bfb0da1e377646e54`
MD5	`65441193579caa3dfb656fc648f24077`
BLAKE2b-256	`4b1df9764abe804e92c81cdd2b491200d4fed7c0ad785b4e7e288a3017aeda7c`

Algorithm	Hash digest
SHA256	`f830409eb96b063ae9f3f4e676f760b0d9738bcb0708ba6b840b7e0c84c490bd`
MD5	`b46428750df654897c0ad4c604f0d8cc`
BLAKE2b-256	`a0d7adad863f5530e354e15092f3905258bd75c56dcbe9ae6923ab1ce56c738e`

Algorithm	Hash digest
SHA256	`8beb4f2c79c676b93ab3a14f86586adb51c3d5a2e3c1a902186e4cd6ed0a2e45`
MD5	`dce4537f84fe83095f8d9bc248ae81e9`
BLAKE2b-256	`f2cf6d7a05ea1bc999e2fde7965077a4f4b87ba5527be5a09e4d29d98c16ded6`

Algorithm	Hash digest
SHA256	`41ae6a7f0139d48b9ce8e0a7c43be003e6fa9382919a7efa76153bd1cdbb5e21`
MD5	`7bdad2991d777f01a5c492dccd23477e`
BLAKE2b-256	`0316d2bfa390c3c38e63ad7d3b871498bc216683d7613f4a5be614ca381f9189`

docling-parse 4.5.0

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Project description

Docling Parse

Quick start

Performance Benchmarks

Characteristics of different parser versions

Timings of different parser versions

Development

CXX

Python

Contributing

References

License

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

Algorithm	Hash digest
SHA256	`e9223485df491432f5549dd4566c6649ff32f54370701a004673e27e6fa94a9e`
MD5	`97bf488d46ed388f1fc33ee4e4c4ce6c`
BLAKE2b-256	`8b0259e40ba1b28585cd69cfdbcf1b5d7e9eb5f25ed059cd85cef68305caefc1`

Algorithm	Hash digest
SHA256	`99e353ab01ac5c81318b67f42c4fc83ac4a0b5b4783bc566f19656204acf45f0`
MD5	`588ccac74bceeaaf6c14dfe24ea04efa`
BLAKE2b-256	`74635ef545ac486600fabc0f2ba37a980a7556ca54f61defc64423674e7facb9`

Algorithm	Hash digest
SHA256	`52df1c5bbafe5199c090bf47eb802c2fe40173fb438200f9a7cbe401aa1eed74`
MD5	`11fd2d05b7fc4c7ca888e85829d5a5ed`
BLAKE2b-256	`1dc2010fbbaa8a44cdeed7ca77b0de4f96cc7e60991c0ae32efe49893372858d`

Algorithm	Hash digest
SHA256	`dac5e9907cd6fd020bc1620082dacb9b99bfc9ee4001c55c4e4ce156edf3b617`
MD5	`28c906932e04ad026c8d8712dd367a2f`
BLAKE2b-256	`d7043f25840217a9f6d9661adc01d76d9bafb48fbe2884f9d58633b017bfb3a7`

Algorithm	Hash digest
SHA256	`da6e535463bcb19a64f3099bb73b299e1f6f49a1ef3b0b3ea4fa62e2790ad875`
MD5	`1a8996bf249d6a8ad715f6e7a8bd32b7`
BLAKE2b-256	`437b2377ccd6297bf0b8925fec0143f04522eeeb5dee4dc237bdac71a04314d9`

Algorithm	Hash digest
SHA256	`affdecc41ed18f1a82c56edac2b815535e3cc07e2b0f8ffaee7e4adfb1333f0e`
MD5	`56cf12e96432dd0c14b21778c2f856a6`
BLAKE2b-256	`33b6ebe5c0b61e64a889f6ddf0d9ac497e14ea75f1c1451ae6c744dd8015fe07`

Algorithm	Hash digest
SHA256	`e8b283a93860cdf43a93296e1721e25daeb8eede14417b9f188f0f52c010d6b5`
MD5	`b8cb7e7924ece448edba9a1158832e56`
BLAKE2b-256	`9d8ca45a7dd3e2cc1e4b6979f3e98c3f4468534f973510e0183d1625917e27ed`

Algorithm	Hash digest
SHA256	`217fe2466ca2723bdecbdb162ca73891c1746ec15b8d99ec203f8df3305091a5`
MD5	`8d80ca4def1548fceb7d6df1659cd688`
BLAKE2b-256	`0bd3249586b3ab091f16ff7f757f0a4f1de60c70b21dc5d7e5f4cf1b3721ce55`