11st of 13 in Data and scraping for AI
mineru
Document parser that converts PDFs, images and Office files to Markdown and JSON
Live demo ↗
(opens in a new tab)Documentation ↗
(opens in a new tab)Website ↗
(opens in a new tab)Repository on GitHub ↗
(opens in a new tab)
- Stars
- 81.8k
- License
- custom license
- Last commit
- Oct 2026
- Last release
- Oct 2026
- Language
- Python
56,300 on 25 Mar 202681,759 on 14 Oct 2026
From GitHub's daily star counts.
Checked on GitHub.
Overview
MinerU parses PDFs, scanned images, Office, OpenDocument, EPUB, OFD, HTML and CSV files into Markdown, HTML, LaTeX, DOCX and structured content lists. It offers four parsing tiers (flash, basic, standard, advanced), a local document library with search, and page/block locators for citations. It ships a CLI, Python SDK, API, router and Gradio WebUI, plus an agent skill.
Who it is for: Engineers feeding PDFs and Office documents to LLM pipelines or agents
Strengths
- Handles scanned PDFs, tables and formulas, with four quality tiers from fast preview to advanced
- Stable doc/tier/page/block locators allow paged reading and citation of long documents
- Small models run on ONNX CPU; the VLM can run on llama.cpp, vLLM or LMDeploy
- Documents are not uploaded to the official service unless remote parsing is configured
Weaknesses
- Office, HTML, EPUB, OFD and CSV files only get flash-tier parsing; higher tiers are PDF and image only
- Docker deployment for non-NVIDIA devices is pending an update
- Highest throughput needs an NVIDIA GPU and mineru[full]; Windows needs torch installed separately
- License is reported as NOASSERTION, so terms need checking before use
What it needs
- GPU optional
- Docker + Compose
- Needs Python >=3.10,<3.15, llama.cpp, vLLM or LMDeploy (VLM runtime), ONNX or Torch
- Models: MinerU VLM, ONNX small models, Torch small models, llama.cpp, vLLM
Head to head
Also in Data and scraping for AI
See all 13| Rank | Project | Score |
|---|---|---|
| 2 | Crawl4AIPython web crawler that converts pages to LLM-ready Markdown and JSON | 77 out of 100 |
| 3 | doclingPython library and CLI that converts PDFs, Office files and more into structured text | 76 out of 100 |
| #4 | markitdownPython tool that converts PDF, Office, HTML and audio files to Markdown for LLMs | 71 out of 100 |
| #5 | FirecrawlWeb scraping and crawling API that returns LLM-ready markdown | 67 out of 100 |
| #6 | langextractPython library that extracts source-grounded structured data from text using LLMs | 60 out of 100 |