// rag · opendatalab/MinerU

MinerU

MinerU is an open-source rag & knowledge project by opendatalab (opendatalab/MinerU on GitHub). It has 82,521 GitHub stars and 6,817 forks, is released under the Apache-2.0 + terms license, and was last updated on GitHub on 26 October 2026.

MinerU — turns PDFs and Office documents into LLM-ready Markdown and JSON for agents and RAG pipelines, Apache-2.0 plus terms

★ 82.5k stars⑂ 6.8k forksApache-2.0 + termsupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

GitHub stars
82,521
Forks
6,817
License
Apache-2.0 + terms
Last updated on GitHub
26 October 2026
Listing
Full install guide
Official site
Documentation
// how it works

How it works

  1. Create a Python 3.12 environment with uv

    The README install route uses uv for a clean virtual environment.

  2. Install MinerU 4.x

    Install the current major line from PyPI into that environment.

  3. Parse a document (or open the web UI)

    Parse a PDF to Markdown at the standard tier, or start the built-in web UI.

// features

Why people love it

Layout-aware document parsing

Tables, formulas, figures and reading order survive the conversion — not just a text dump.

Built for agents, not just humans

Page and block locators let an agent re-read exactly the passage it cited, instead of re-parsing the whole file.

Tiers for speed vs quality

The standard tier balances accuracy and speed; the README documents other tiers and runtimes for heavier jobs.

A Python SDK and a web UI

Use it from the command line, drive a local document library from Python, or parse through the browser UI.

Advertisement
// run it

Run it yourself

  1. Install with uv

    The README-preferred install: a Python 3.12 venv, then the 4.x line.

    pip install uv
    uv venv .mineru --python 3.12
    source .mineru/bin/activate
    uv pip install -U "mineru>=4.0,<5"
  2. Parse a document

    The README command: parse a PDF to Markdown at the standard tier.

    mineru-kit parse document.pdf -o document.md --tier standard
  3. Open the web UI

    The built-in browser interface for parsing without the command line.

    mineru-kit webui
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who makes MinerU?

The OpenDataLab team, as the document-parsing front end for LLM and agent workflows.

Is MinerU free?

Yes for ordinary use — Apache-2.0 plus additional terms: a separate commercial licence is only required at 100M monthly active users or $20M monthly revenue, and online services built on it must attribute MinerU.

How is MinerU different from a PDF text extractor?

It preserves layout, tables, formulas and reading order, and returns stable page/block locators for citations — a text dump does neither.

Is MinerU a RAG framework?

No — the README says so plainly: it is a document reader, not a vector database or chat-with-documents app. It feeds RAG systems; it is not one.

How do I get started?

Install mineru 4.x with uv into a Python 3.12 environment, then run mineru-kit parse on a PDF.

// keep exploring

Similar tools

RAG & Knowledge

knowhere

Knowhere turns documents into structured, hierarchy-native chunks ready for agents and RAG.

★ 3.7k starsApache-2.0
View guide →
RAG & Knowledge

opendataloader-pdf

Turn PDFs into AI-ready data: extract Markdown, JSON and tables — and auto-tag for accessibility

★ 29.5k starsApache-2.0
View guide →
RAG & Knowledge

Marker

Marker — converts PDFs to Markdown and JSON quickly and accurately, with layout, tables and math intact, Apache-2.0

★ 40.6k starsApache-2.0
View guide →
RAG & Knowledge

PaddleOCR

Lightweight OCR toolkit turning PDFs and images into structured, LLM-ready data in 100+ languages

★ 90.8k starsApache-2.0
View guide →
RAG & Knowledge

llm-app

Ready-to-run templates for RAG, AI pipelines and enterprise search that stay in sync with live data

★ 58.8k starsMIT
View guide →
RAG & Knowledge

WeKnora

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

★ 31.9k starsUnknown
View guide →
// alternatives

Alternatives in RAG & Knowledge

The most-starred other RAG & Knowledge projects in the LibreAI catalogue — the realistic shortlist if MinerU is not the right fit.

// more in rag

More in RAG & Knowledge

Nearby RAG & Knowledge projects in the catalogue, closest in stars to MinerU — keep exploring the shelf either side of it.

Get MinerU

Free and open — grab the source, star the repo, and start creating.