11st of 29 in Data and scraping for AIFor data and documents, documents and ocr
mineru
Document parser that converts PDFs, images and Office files to Markdown and JSON
- Stars
- 82.4k
- License
- custom license
- Last commit
- Oct 2026
- Last release
- Oct 2026
- Language
- Python
56,419 on 27 Mar 202682,403 on 23 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
Ranked among open-source alternatives to Apify (#1 of 10) and LlamaParse (#1 of 10).
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
Quick answers
Is mineru open source?
Its code is public on GitHub under its own license terms; read them before you use it at work.
Can you run mineru with Docker?
Yes. Its repository has a Docker setup: a Dockerfile, a Compose file or a published image.
Does mineru need a GPU?
No. It runs on a CPU and can use a GPU when you have one.
Head to head
Also in Data and scraping for AI
See all 29| Rank | Project | Score |
|---|---|---|
| 2 | doclingPython library and CLI that converts PDFs, Office files and more into structured text | 91 out of 100 |
| 3 | markitdownPython library and CLI that converts office files, PDFs and audio to Markdown | 86 out of 100 |
| #4 | Crawl4AIAsync Python web crawler that outputs LLM-ready Markdown and structured JSON | 84 out of 100 |
| #5 | opendataloader-pdfPDF parser that outputs Markdown, JSON with bounding boxes, and Tagged PDF | 84 out of 100 |
| #6 | scrapegraph-aiPython library that builds LLM-driven scraping pipelines from a prompt and a URL | 81 out of 100 |