Integration: Docling Serve
Use Docling Serve to convert PDF, DOCX, HTML, and other document types to Haystack Documents via a remote HTTP server, with no local ML dependencies
Table of Contents
Overview
Docling Serve hosts Docling as a scalable HTTP server, supporting PDFs, Office documents, HTML, and many other formats. All document parsing happens on the remote server, with no local ML dependencies.
Installation
pip install docling-serve-haystack
Start a Docling Serve instance locally (requires Docker):
docker run -p 5001:5001 ghcr.io/docling-project/docling-serve-cpu:latest
Usage
Components
DoclingServeConverter converts documents by sending them to a Docling Serve HTTP server. Local files and ByteStream objects are uploaded via the /v1/convert/file endpoint. URL strings are
sent to /v1/convert/source.
The component supports three export modes via the export_type parameter:
ExportType.MARKDOWN(default): Returns document content as a Markdown string.ExportType.TEXT: Returns plain text extracted from the document.ExportType.JSON: Returns the full Docling document representation as a JSON string.
Standalone
from haystack_integrations.components.converters.docling_serve import (
DoclingServeConverter,
)
# Default: Markdown output
converter = DoclingServeConverter(base_url="http://localhost:5001")
result = converter.run(sources=["https://arxiv.org/pdf/2602.17316"])
documents = result["documents"]
print(documents[0].content[:200])
In a Pipeline
from haystack import Pipeline
from haystack.components.preprocessors import DocumentSplitter
from haystack.components.writers import DocumentWriter
from haystack.document_stores.in_memory import InMemoryDocumentStore
from haystack_integrations.components.converters.docling_serve import (
DoclingServeConverter,
)
document_store = InMemoryDocumentStore()
pipeline = Pipeline()
pipeline.add_component(
"converter",
DoclingServeConverter(base_url="http://localhost:5001"),
)
pipeline.add_component("splitter", DocumentSplitter())
pipeline.add_component("writer", DocumentWriter(document_store=document_store))
pipeline.connect("converter", "splitter")
pipeline.connect("splitter", "writer")
pipeline.run({"converter": {"sources": ["https://arxiv.org/pdf/2602.17316"]}})
License
docling-serve-haystack is distributed under the terms of the Apache-2.0 license.