Skip to main content

Docling Core

PyPI version Python uv Ruff Pydantic v2 prek License MIT

Docling Core is a library that defines core data types and transformations in Docling.

Installation

To use Docling Core, simply install docling-core from your package manager, e.g. pip:

pip install docling-core

Development setup

To develop for Docling Core, you need Python 3.10 through 3.15 and the uv package. You can then install it from your local clone's root directory:

uv sync --all-extras

To run the pytest suite, execute:

uv run pytest -s test

Main features

Docling Core provides the foundational DoclingDocument data model and API, as well as additional APIs for tasks like serialization and chunking, which are key to developing generative AI applications using Docling.

DoclingDocument

Docling Core defines the DoclingDocument as a Pydantic model, allowing for advanced data model control, customizability, and interoperability.

In addition to specifying the schema, it provides a handy API for building documents, as well as for basic operations, e.g. exporting to various formats, like Markdown, HTML, and others.

👉 More details:

Serialization

Different users can have varying requirements when it comes to serialization. To address this, the Serialization API introduces a design that allows easy extension, while providing feature-rich built-in implementations (on which the respective DoclingDocument helpers are actually based).

👉 More details:

Chunking

Similarly to above, the Chunking API provides built-in chunking capabilities as well as a design that enables easy extension, this way tackling customization requirements of different use cases.

👉 More details:

Profiling

The Profiling API enables extraction of comprehensive statistics from DoclingDocument objects, both for individual documents and collections. It provides metrics on document structure (pages, tables, pictures, text items) along with statistical distributions (deciles, histograms) and visualization capabilities for analyzing document collections at scale.

👉 More details:

Configuration

Runtime settings are read from environment variables with the DOCLINGCORE_ prefix, or set in code via docling_core.utils.settings.settings.

Local image files

Images in a DoclingDocument may reference a local file, either as a filesystem path or as a file:// URI. Since such documents may come from untrusted sources, docling-core does not read these files by default, and raises a ValueError instead. This affects, for example, documents saved with ImageRefMode.REFERENCED and loaded again.

For trusted documents, either enable it globally:

export DOCLINGCORE_ALLOW_IMAGE_FILE_URI=true
from docling_core.utils.settings import settings

settings.allow_image_file_uri = True

or per document, reading its local images into memory at load time:

from docling_core.types.doc import DoclingDocument

doc = DoclingDocument.load_from_json("doc.json", allow_local_images=True)
# or, for a document obtained otherwise:
doc.load_local_images(base_dir=...)

Contributing

Please read Contributing to Docling Core for details.

References

If you use Docling Core 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 Core codebase is under MIT license. For individual model usage, please refer to the model licenses found in the original packages.

Metadata

Release files for docling-core 2.107.1

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

Source distribution (sdist)

Source distribution for docling-core 2.107.1
File Size Uploaded Provenance Actions
docling_core-2.107.1.tar.gz 501.0 kB With provenance Details for docling_core-2.107.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for docling-core 2.107.1
File Interpreter ABI Platform Actions
docling_core-2.107.1-py3-none-any.whl Python 3 none any Details for docling_core-2.107.1-py3-none-any.whl

Total release size: 847.8 kB

Release files / docling_core-2.107.1.tar.gz

Download URL docling_core-2.107.1.tar.gz
Size 501.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4995732b31ba755bbc242dd73a1c5d488d82a6824399d98280687749bf19e4e8
BLAKE2b-256 checksum
How to use checksums
a7ba2d5072ceea98926ecf045fec92ae39cfcd31883981a0d3f9f690977cd15b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / docling_core-2.107.1-py3-none-any.whl

Download URL docling_core-2.107.1-py3-none-any.whl
Size 346.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
12c6af0736098b5e8a7546fdbbf2caf68c1a5e446734efcf6bccae27e184e073
BLAKE2b-256 checksum
How to use checksums
a2318e47ae5f05828a617eaea62ccf144d84bba5505f8b24e1a62ac117bdda19
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for docling-core 2.107.1

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for docling_core-2.107.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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

2.107.1 This release

2 release files Full 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