docling-core2.38.1
Published
A python library to define and validate data types in Docling.
pip install docling-core
Package Downloads
Project URLs
Requires Python
<4.0,>=3.9
Dependencies
- jsonschema
<5.0.0,>=4.16.0
- pydantic
!=2.10.0,!=2.10.1,!=2.10.2,<3.0.0,>=2.6.0
- jsonref
<2.0.0,>=1.1.0
- tabulate
<0.10.0,>=0.9.0
- pandas
<3.0.0,>=2.1.4
- pillow
<12.0.0,>=10.0.0
- pyyaml
<7.0.0,>=5.1
- typing-extensions
<5.0.0,>=4.12.2
- typer
<0.17.0,>=0.12.5
- latex2mathml
<4.0.0,>=3.77.0
- semchunk
<3.0.0,>=2.2.0; extra == "chunking"
- transformers
<5.0.0,>=4.34.0; extra == "chunking"
- semchunk
; extra == "chunking-openai"
- tiktoken
<0.10.0,>=0.9.0; extra == "chunking-openai"
Docling Core
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.9 / 3.10 / 3.11 / 3.12 / 3.13 and uv. You can then install from your local clone's root dir:
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:
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.