Files
kotaemon/docs/integrations/docling.md
Khoi-Nguyen Nguyen-Ngoc 9ad3e4e49a feat: integrate PaddleOCR as document loaders + enhance chat/index UX (#814)
* docs: typo

* fix: enhance mention @ (file, websearch) in chat

* fix: shorter placeholder guide in chat

* fix: enhance UI (file filter, chunks preview, lightrag reader settings)

* feat: feat: integrate paddleocr (PaddleOCR-VL, PP-StructureV3)

* fix: import

* fix: support both urls and mention files when chatting

* feat: restore the test connection panel in resources

* fix: paddleocr output adapter

* tests: update

* fix: parse image block content

* fix: docker gpu stage for paddleocr

* tests: update unit tests

* tests: add skip_when_paddleocr_not_installed

* fix: reset chunk preview filter when re-selecting file

* fix: paddleocr[all] -> paddleocr[doc-parser]

* fix: allow configure paddleocr device with env

* feat: parameterize CUDA version in Dockerfile for paddlepaddle installation

* docs: add integration guides for PaddleOCR and Docling

* fix: updating mcp server must reflect in the tool choice UI

* fix: disable enable_mkldnn for cpu inference

* docs: update installation doc with uv

* fix: use chat_input_text for llm input instead of the UI display message

* fix: render file mentions as HTML and support unquoted names

* fix: ensures proper cleanup of event listeners before replacing the Tribute instance.

* test: updae unit tests

---------

Co-authored-by: GSD Agent <kotaemon@example.com>
2026-05-30 21:02:58 +07:00

30 lines
1.0 KiB
Markdown

# Docling
Kotaemon provides a [Docling](https://github.com/DS4SD/docling) reader to enable local document ingestion with structure-aware parsing, including text, tables, and figures.
The reader is located under `kotaemon/loaders/docling_loader`.
## Prerequisites
- Install Docling:
```bash
uv pip install -e "libs/kotaemon[docling]"
```
- Configure optional figure captioning:
Docling can generate figure captions when a VLM endpoint is available. Set `KH_VLM_ENDPOINT` in your `.env` file or application settings to enable captioning.
```bash
KH_VLM_ENDPOINT=http://your-vlm-endpoint
```
If `KH_VLM_ENDPOINT` is not set, Docling will still extract text, tables, and figure metadata, but it will skip generated figure captions.
## Configure the loader
1. Run Kotaemon and open the app UI.
2. Navigate to Settings → Retrieval Settings → File loader.
3. Select `Docling (figure+table extraction)`.
4. Save the settings, then upload or ingest a document. Kotaemon will use Docling during indexing and convert extracted content into `Document` objects.