What do you want to do?
3 use cases
-
Parse a hard PDF into Markdown on your own machine
Install MinerU 4, check which tier your hardware suits and convert a document locally.
- REPO
opendatalab/MinerU - Claude Code
- Codex
- Cursor
- Research
- Intermediate
View prompt
Install opendatalab/MinerU 4 in a uv virtual environment, run `mineru-kit hardware detect`, then convert <file> with mineru-kit parse at the tier it recommends. Tell me how long it took and whether tables and formulas survived.
- REPO
-
Let your agent read long documents page by page
Install the MinerU skill so an agent parses a file, reads it in chunks and keeps stable citation locators.
- REPO
opendatalab/MinerU - Claude Code
- Codex
- Cursor
- Research
- Intermediate
View prompt
Install the opendatalab/MinerU skill, then read <document> progressively with mineru parse and the returned locators. Answer <question> and cite the page and block locator for every claim.
- REPO
-
Search inside your parsed documents from Python
Run the MinerU server and use DoclibClient to parse, cache and read documents from your own scripts.
- REPO
opendatalab/MinerU - Claude Code
- Codex
- Cursor
- Research
- Intermediate
View prompt
Using opendatalab/MinerU, start the server and write a Python script with DoclibClient that parses every PDF in <folder>, waits for each parse, and prints page 1 of each with its locator. Then search the library for <phrase>.
- REPO
Quick start with MinerU
- Check you have what it needs: Python 3.11 to 3.14 in a virtual environment; Windows, Linux or macOS; CPU works, compatible GPUs are used automatically; Model downloads for the tier you choose.
- Open opendatalab/MinerU on GitHub and read the README and license.
- Install MinerU 4.x in a Python 3.11 to 3.14 virtual environment with uv, as the Install Manually section of the README shows
- Run
mineru-kit hardware detectto see your devices and get a tier recommendation - For a quick read of a document, run
mineru parse document.pdf --json, which defaults to the first 10 PDF pages - For a full conversion of all pages, use the stateless
mineru-kit parsecommand
These steps come from our top use case, Parse a hard PDF into Markdown on your own machine, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for opendatalab/MinerU
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers and AI agent users who need high-quality parsing of complex PDFs and a searchable local library of parsed documents.
- Why it is hot83k stars, talked about in 2 AI sources we track
- LanguagePython
- Sourcegithub.com/opendatalab/MinerU ยท Back to Hot repos
Requirements
- Python 3.11 to 3.14 in a virtual environment
- Windows, Linux or macOS; CPU works, compatible GPUs are used automatically
- Model downloads for the tier you choose
- Optional: Node.js for npx to install the agent skill
Add this badge to your README
Maintain MinerU? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/opendatalab-mineru/?utm_source=github&utm_medium=badge&utm_campaign=opendatalab-MinerU)
HTML
<a href="https://dedupedai.com/use-cases/opendatalab-mineru/?utm_source=github&utm_medium=badge&utm_campaign=opendatalab-MinerU"><img src="https://dedupedai.com/badge/opendatalab/MinerU.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about MinerU
What is MinerU?
MinerU turns PDFs, images and office documents into LLM-ready Markdown and JSON. Version 4 adds four parsing tiers (Flash, Basic, Standard, Advanced), a local document library with search and stable citation locators for page and block continuation, a Python SDK, a V1 API, a Gradio WebUI and an agent skill, with CPU inference plus automatic GPU acceleration on Intel, AMD, NVIDIA and Apple Silicon. It is an open-source project on GitHub: https://github.com/opendatalab/MinerU.
How do I use MinerU?
Install MinerU 4.x in a Python 3.11 to 3.14 virtual environment with uv, as the Install Manually section of the README shows; then run mineru-kit hardware detect to see your devices and get a tier recommendation; For a quick read of a document, run mineru parse document.pdf --json, which defaults to the first 10 PDF pages. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is MinerU for?
Developers and AI agent users who need high-quality parsing of complex PDFs and a searchable local library of parsed documents.
What can I do with MinerU?
3 use cases so far, for example: Parse a hard PDF into Markdown on your own machine; Let your agent read long documents page by page; Search inside your parsed documents from Python. Each has steps and a copy-paste agent prompt.
What do I need to run MinerU?
Python 3.11 to 3.14 in a virtual environment; Windows, Linux or macOS; CPU works, compatible GPUs are used automatically; Model downloads for the tier you choose; Optional: Node.js for npx to install the agent skill.
What are alternatives to MinerU?
Other hot AI repos in Research: Sam2, Docling, LightRAG, Ragflow, Markitdown.
Is MinerU safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.