DocMeld

DocMeld Lightweight Doc to agent-ready knowledge pipeline

Quick Start • Architecture • Python API • CLI • Configuration • Contributing

---

DocMeld converts PDF, Word, and PowerPoint documents into structured, agent-consumable formats through a three-stage pipeline — without requiring expensive OCR, VLM, or multimodal models. Built for the age of AI agents, it bridges the gap between static documents and the structured knowledge that LLMs need.

Most tools stop at format conversion. DocMeld goes further: Document → Structured Elements → Page Knowledge → AI-Enriched Metadata, producing outputs ready for RAG pipelines, agent systems, and downstream AI workflows.

Supported formats: .pdf, .docx, .doc (via LibreOffice), .pptx, .ppt (via LibreOffice).

Why DocMeld?

	DocMeld	MinerU	Docling	Marker	MarkItDown
No ML models required	✅	❌	❌	❌	✅
Runs fully offline (core)	✅	❌	✅	✅	✅
Agent-ready outputs	✅	❌	❌	❌	❌
AI metadata enrichment	✅	❌	❌	❌	❌
Lightweight install	✅	❌	❌	❌	✅
MIT license	✅	❌ (AGPL)	✅	❌ (GPL)	✅
Swappable backends	✅	❌	N/A	❌	❌

Quick Start

Installation

pip install docmeld

Optional backends for richer formats:

pip install docmeld[docling]   # Docling backend (DOCX + advanced PDF)
pip install docmeld[pptx]      # PowerPoint (.pptx) via python-pptx
pip install docmeld[office]    # Everything: Docling + python-pptx

Legacy .doc / .ppt additionally require LibreOffice (soffice) on your PATH.

Process your first document

from docmeld import DocMeldParser

parser = DocMeldParser("research_paper.pdf")   # or .docx / .pptx
result = parser.process_all()
print(f"Processed {result.successful}/{result.total_files} files in {result.processing_time_seconds}s")

Or from the command line:

docmeld process research_paper.pdf
docmeld process quarterly_deck.pptx --backend auto

That's it. Your document is now structured JSON, page-by-page JSONL, and (optionally) AI-enriched metadata.

Pipeline Architecture

DocMeld uses a three-stage medallion architecture. Each stage is independently runnable and idempotent — re-running skips already-processed files.

┌─────────────┐      ┌─────────────┐      ┌─────────────┐
│   BRONZE    │      │   SILVER    │      │    GOLD     │
│             │      │             │      │             │
│  Doc → JSON │─────▶│ JSON → JSONL│─────▶│ JSONL → AI  │
│  elements   │      │  pages      │      │  metadata   │
│             │      │             │      │             │
│  PyMuPDF /  │      │  Title      │      │  DeepSeek   │
│  Docling /  │      │  hierarchy  │      │  enrichment │
│  python-pptx│      │             │      │             │
└─────────────┘      └─────────────┘      └─────────────┘
   offline              offline            requires API key

Bronze: Document → Structured JSON

Extracts document elements (titles, text, tables, images, charts, formulas, SmartArt, speaker notes, comments, and more) into a unified JSON format with element IDs and parent-child hierarchy. The page unit is the physical page for PDF/Word and the slide for PowerPoint.