Doctopus

Many arms. One API.

Turn documents into structured, LLM-ready data with a single self-hosted gateway.

Documentation · Formats · Quick start · Interfaces · Routing · Benchmarks · Deploy

---

Doctopus parses PDFs, Office documents, and scans into Markdown, text, tables, and structured blocks. Use it from Python, the command line, a REST API, or an MCP client. Behind each interface is the same gateway: it selects an available processing engine, explains its decision, and can try an alternative when extraction fails or looks suspicious.

• Start light. Xberg is the default engine, with OCR, table extraction, and document structure.
• Bring in Docling when you need it. Install the optional backend for its richer layout taxonomy, select it explicitly, or let the gateway escalate when appropriate.
• Add PaddleOCR for document images. Install the optional CPU PP-StructureV3 backend for OCR, layout, and tables, then select it explicitly. Formula recognition is opt-in.
• Keep one output shape. A versioned document schema carries content, metadata, and processing details across backends.
• Know what happened. Routing reasons, warnings, timings, and fallback details travel with the result.
• Run it yourself. Use it locally or in Docker, without a per-page API service.

Supported formats

Input

Category	Formats	Engines	Base install
PDF		All eight engines	✅
Word processing		DOCX: xberg, docling, mineru, markitdown · RTF: xberg	✅
Presentations		xberg, docling, mineru, markitdown	✅
Spreadsheets		XLSX, CSV: xberg, docling, mineru, markitdown · XLS: markitdown	XLSX, CSV
Web and text		HTML: xberg, docling, mineru, markitdown · Markdown: xberg, docling, markitdown · TXT: xberg, markitdown · JSON, XML: markitdown	HTML, Markdown, TXT
Ebooks		EPUB: xberg, mineru, pymupdf4llm, markitdown · MOBI, FB2, CBZ: pymupdf4llm	EPUB
Email		EML: xberg · MSG: markitdown	EML
Images and scans		PNG, JPEG: xberg, docling, paddleocr, marker, mineru, ollama · TIFF: xberg, docling, paddleocr, marker, ollama · BMP: paddleocr · WebP: marker, ollama	PNG, JPEG, TIFF
Vector and fixed layout		pymupdf4llm	—

Base install means the xberg engine that ships with pip install doctopus-ai; the other engines are optional. Both .jpg and .jpeg are accepted; .htm is accepted by Xberg and MarkItDown, and .tif by PaddleOCR. The router picks a compatible installed engine automatically, and doctopus backends list --json reports the exact extensions each installed engine accepts.

Output

Format	What you get	How to get it
	The whole document as Markdown, tables included	doctopus parse (default) · doc.markdown · markdown field in REST and MCP
	The extracted text without Markdown syntax	doctopus parse --format text · doc.text
	The versioned Document (schema 1.0): metadata, Markdown, text, blocks with bounding boxes, tables as Markdown and rows, pages, and processing details	doctopus parse --format json · POST /v1/parse · doc.model_dump_json()
	One layout-aware chunk per line, with heading path, pages, and source; tables are never split	doctopus chunk · POST /v1/chunk · MCP chunk_document
	Typed Document and Chunk objects	doctopus.parse() · doctopus.chunk()

See Output for every field.

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗