Was ist MinerU?
MinerU wandelt PDFs, Scans und Bilder sowie Word-, PowerPoint-, Excel-, EPUB-, OFD-, HTML- und CSV-Dateien in Markdown, HTML, LaTeX, DOCX oder strukturiertes JSON um und erhält dabei Tabellen, Formeln und Lesereihenfolge. Entwickelt wird es von OpenDataLab, das auch den Benchmark OmniDocBench pflegt, und sein Vision-Modell MinerU2.5-Pro wird darüber ausgeliefert.
Version 4.0 vom 16. September 2026 ordnete es in vier Stufen neu: Flash liest die eigene Textebene eines PDFs, Basic ergänzt kleine Modelle für OCR, Formeln und Tabellen, die auf der CPU laufen, und Standard und Advanced ergänzen das Vision-Modell mit 1,2 Milliarden Parametern, betrieben über llama.cpp, vLLM oder LMDeploy. Hinzu kam eine lokale Dokumentbibliothek, die Agenten durchsuchen und nach Seite und Block zitieren können. Version 4.1 brachte automatische GPU-Erkennung für Hardware von Intel, AMD, NVIDIA und Apple und eine neue asynchrone Tasks-API.
Die Lizenz änderte sich im April 2026. Version 3.1.0 ersetzte AGPLv3 durch die MinerU Open Source License, Apache 2.0 plus Bedingungen, die ab 100 Millionen monatlich aktiven Nutzern oder 20 Millionen $ Monatsumsatz eine kommerzielle Lizenz verlangen und von darauf gebauten Diensten verlangen, die Nutzung von MinerU anzugeben.
Lohnt sich MinerU?
MinerUs Modell liegt nahe der Spitze, und die Belege sind besser als reine Selbstauskunft. OpenDataLab meldet für MinerU2.5-Pro 95,69 auf OmniDocBench v1.6, 2,71 Punkte mehr bei derselben Architektur mit 1.2B, allein durch Arbeit an den Daten. Der Vorbehalt: OpenDataLab pflegt OmniDocBench und hat v1.6 im selben Paper definiert. Die Tabelle eines Konkurrenten, in TIIs Model Card zu Falcon OCR, ist bescheidener, aber immer noch stark: 93,22 auf OmniDocBench, hinter PaddleOCR-VL-1.6 mit 94,95, und 81,5 auf olmOCR-bench, in dieser Tabelle nur hinter dots.mocr, Chandra OCR 2 und Falcon OCR selbst.
Die Lizenz muss man genau lesen. Der Abschied von AGPLv3 im April 2026 beseitigte die Copyleft-Pflicht, und die Schwellen, 100 Millionen monatliche Nutzer oder 20 Millionen $ Monatsumsatz, betreffen die meisten Unternehmen nicht. Aber jeder auf MinerU gebaute Online-Dienst muss das deutlich angeben, und wer das versäumt, verliert die Lizenz automatisch. Es ist keine von der OSI anerkannte Lizenz, und manche Rechtsabteilungen werden sie wie eine behandeln, die sie prüfen müssen. Die Vorgeschichte mahnt zusätzlich zur Vorsicht: Das Repository wechselte im März 2026 von AGPL zu Apache und wieder zurück, bevor es sich im April festlegte.
Die Stufen sind ein echter Kompromiss. Flash und Basic laufen auf gewöhnlichen CPUs, und auf einem Rechner ohne GPU wird die Stufe Standard nur ab 12 logischen Kernen automatisch aktiviert; die Stufen mit Vision-Modell wollen eine GPU, wobei 8 GB VRAM als Ausgangspunkt für die Planung beschrieben werden, nicht als Garantie. Die Model Card meldet 2,12 Seiten pro Sekunde auf einer A100 mit vLLM. Die Maintainer von Marker maßen MinerUs ältere Pipeline mit 72,7 auf olmOCR-bench und 0,54 Seiten pro Sekunde auf einer B200, die Ergebnisse hängen also stark davon ab, welche Stufe und Version läuft.
Das Projekt bewegt sich schnell. Zwischen 4.0.0 am 16. September und 4.1.4 am 2. November gab es 18 Releases, und 4.1 brach die HTTP-API, sodass Server, Router, SDKs und Clients zusammen aktualisiert werden mussten. Mit 82.996 Sternen und nur 11 offenen Issues wird es klar aktiv gepflegt; der Preis dafür ist, dass das Festlegen einer Version und das Lesen der Migrationsanleitung zum Betrieb gehören.
Wo es sich lohnt
Ein ML-Engineer, der Retrieval über 500.000 chinesische und englische Forschungsarbeiten aufbaut
PDFs mit Formeln und Tabellen in sauberes Markdown umwandeln
Lass mineru-kit parse in der Stufe Standard mit vLLM auf einem GPU-Host laufen. Bei den 2,12 Seiten pro Sekunde auf einer A100 laut Model Card dauern 5 Millionen Seiten (zehn pro Arbeit) auf einer Karte etwa 27 Tage, verteile also mit dem Router für mehrere Dienste auf mehrere GPUs.
Ein Plattformteam, das Coding-Agenten Zugriff auf interne Dokumente gibt
Agenten lange Dokumente Seite für Seite lesen und genaue Stellen zitieren lassen
Installiere den Skill mineru und starte die lokale Dokumentbibliothek; Agenten parsen einmal und lesen dann über Locator für Dokument, Seite und Block, statt ganze Dateien zu laden. Dokumente werden nicht hochgeladen, sofern kein entferntes Parsing konfiguriert ist.
Eine Verantwortliche für Legal Operations bei einem SaaS-Unternehmen, das einen Parser in sein Produkt einbaut
Die Lizenz prüfen, bevor MinerU an Kunden ausgeliefert wird
Unter den Schwellen von 100 Millionen Nutzern und 20 Millionen $ Monatsumsatz ist keine kommerzielle Lizenz nötig, aber die Oberfläche oder die öffentliche Dokumentation des Produkts muss angeben, dass es MinerU nutzt, sonst erlischt die Lizenz.
Bevor du dich festlegst
- Einrichtung
- Python 3.11 bis 3.14: uv pip install -U "mineru>=4.0,<5", dann mineru-kit parse document.pdf -o document.md --tier standard. Für Betrieb mit hohem Durchsatz auf NVIDIA mineru[full] nutzen; Modelle werden von Hugging Face oder ModelScope geladen.
- Integrationen
- CLI, Python-SDK (DoclibClient), V1-HTTP- und Tasks-APIs, ein Router für mehrere Dienste, eine Weboberfläche mit Gradio, ein Agent Skill und eine Option für einen entfernten VLM-Endpunkt; neun Ausgabeformate, darunter Markdown, HTML, LaTeX, DOCX und JSON-Inhaltslisten.
- Daten und Datenschutz
- Läuft lokal; laut Dokumentation werden Dokumente nicht an den offiziellen Dienst hochgeladen, sofern entferntes Parsing nicht ausdrücklich konfiguriert ist. Die Gewichte von MinerU2.5-Pro stehen unter Apache 2.0; das Toolkit unter der MinerU Open Source License.
- Kosten im großen Maßstab
- Selbst gehostet sind die Kosten Hardware: Flash und Basic laufen auf CPUs, die Dokumentation rät für höheren Durchsatz zu mindestens 16 GB Arbeitsspeicher, und MinerU2.5-Pro erreichte 2,12 Seiten pro Sekunde auf einer A100 mit vLLM.
- Grenzen
- Die automatische Stufenwahl prüft den GPU-Speicher nicht; Docker für Geräte ohne NVIDIA wartet auf ein Update; Office- und Webformate nutzen nur Flash; die HTTP-APIs haben sich in 4.1 inkompatibel geändert.
Was gut ist
- MinerU2.5-Pro erreicht im Vergleich eines Konkurrenten (TII) 93,22 auf OmniDocBench
- Vier Stufen, vom Parsen der Textebene auf der CPU bis zum Parsen mit Vision-Modell auf der GPU
- Office, EPUB, OFD, HTML und CSV werden nativ geparst
- Sehr aktiv: 18 Releases von Mitte September bis Anfang November 2026
Was nicht
- Eigene Lizenz mit Nennungspflicht und Umsatzschwellen
- OpenDataLab betreibt auch OmniDocBench, seinen wichtigsten Benchmark
- Inkompatible Änderung der HTTP-API in 4.1
- Lizenzdatei wechselte im März und April 2026 dreimal zwischen AGPL und Apache
Am besten für
RAG- und Datenteams, die große, gemischte Sammlungen von PDFs und Office-Dateien auf eigener Hardware parsen und eine Nennungsklausel akzeptieren können.
Alternativen zu MinerU
MinerU: häufige Fragen
- Lohnt sich MinerU?
- MinerU verbindet eines der genauesten offenen Dokumentmodelle mit einem regen, gut dokumentierten Toolkit, auch wenn seine Lizenz kein einfaches Open Source mehr ist und seine APIs sich ständig ändern. Wir bewerten es mit 4.3 von 5.
- Was kostet MinerU?
- Kostenlos unter der MinerU Open Source License (Apache 2.0 mit zusätzlichen Bedingungen); ab 100 Millionen monatlich aktiven Nutzern oder 20 Millionen $ Monatsumsatz ist eine separate kommerzielle Lizenz nötig.
- Welche Nachteile hat MinerU?
- Eigene Lizenz mit Nennungspflicht und Umsatzschwellen; OpenDataLab betreibt auch OmniDocBench, seinen wichtigsten Benchmark; Inkompatible Änderung der HTTP-API in 4.1; Lizenzdatei wechselte im März und April 2026 dreimal zwischen AGPL und Apache.
- Für wen eignet sich MinerU?
- RAG- und Datenteams, die große, gemischte Sammlungen von PDFs und Office-Dateien auf eigener Hardware parsen und eine Nennungsklausel akzeptieren können.
- Was kostet MinerU für ein Team oder im Produktivbetrieb?
- Selbst gehostet sind die Kosten Hardware: Flash und Basic laufen auf CPUs, die Dokumentation rät für höheren Durchsatz zu mindestens 16 GB Arbeitsspeicher, und MinerU2.5-Pro erreichte 2,12 Seiten pro Sekunde auf einer A100 mit vLLM.
- Ist MinerU sicher für Firmendaten?
- Läuft lokal; laut Dokumentation werden Dokumente nicht an den offiziellen Dienst hochgeladen, sofern entferntes Parsing nicht ausdrücklich konfiguriert ist. Die Gewichte von MinerU2.5-Pro stehen unter Apache 2.0; das Toolkit unter der MinerU Open Source License.
- Was sind die besten Alternativen zu MinerU?
- Die nächsten Alternativen, die wir getestet haben, sind Docling, Marker und Unstructured.
Antworten geprüft am 2. Nov. 2026.
Du entwickelst MinerU? Zeig diese Bewertung auf deiner Website
