Qu’est-ce que MinerU ?
MinerU convertit des PDF, des numérisations et des images, ainsi que des fichiers Word, PowerPoint, Excel, EPUB, OFD, HTML et CSV, en Markdown, HTML, LaTeX, DOCX ou JSON structuré, en conservant tableaux, formules et ordre de lecture. Il est développé par OpenDataLab, qui maintient aussi le benchmark OmniDocBench, et son modèle de vision, MinerU2.5-Pro, est distribué par son intermédiaire.
La version 4.0, sortie le 16 septembre 2026, l'a réorganisé en quatre niveaux : Flash lit la couche de texte propre au PDF, Basic ajoute de petits modèles d'OCR, de formules et de tableaux qui tournent sur CPU, et Standard et Advanced ajoutent le modèle de vision de 1,2 milliard de paramètres servi par llama.cpp, vLLM ou LMDeploy. Elle a aussi ajouté une bibliothèque de documents locale que les agents peuvent interroger et citer par page et par bloc. La version 4.1 a apporté la détection automatique des GPU Intel, AMD, NVIDIA et Apple et une nouvelle API Tasks asynchrone.
La licence a changé en avril 2026. La version 3.1.0 a remplacé l'AGPLv3 par la MinerU Open Source License, soit Apache 2.0 plus des conditions qui exigent une licence commerciale au-delà de 100 millions d'utilisateurs actifs mensuels ou de 20 millions de dollars de chiffre d'affaires mensuel, et qui obligent les services construits dessus à indiquer qu'ils utilisent MinerU.
MinerU vaut-il le coup ?
Le modèle de MinerU est près du sommet du domaine, et les preuves vont au-delà de la seule autodéclaration. OpenDataLab annonce 95,69 pour MinerU2.5-Pro sur OmniDocBench v1.6, soit 2,71 points de mieux sur la même architecture de 1,2B grâce au seul travail sur les données. La réserve est qu'OpenDataLab maintient OmniDocBench et a défini la v1.6 dans le même article. Le tableau d'un concurrent, dans la fiche du modèle Falcon OCR de TII, est plus modeste mais reste solide : 93,22 sur OmniDocBench, derrière PaddleOCR-VL-1.6 à 94,95, et 81,5 sur olmOCR-bench, derrière seulement dots.mocr, Chandra OCR 2 et Falcon OCR lui-même dans ce tableau.
La licence demande une lecture attentive. L'abandon de l'AGPLv3 en avril 2026 a supprimé l'obligation copyleft, et les seuils, 100 millions d'utilisateurs mensuels ou 20 millions de dollars de chiffre d'affaires mensuel, ne toucheront pas la plupart des entreprises. Mais tout service en ligne construit sur MinerU doit le signaler de façon visible, et ne pas le faire met automatiquement fin à la licence. Ce n'est pas une licence approuvée par l'OSI, et certains services juridiques la traiteront comme une licence à examiner. L'historique incite aussi à la prudence : le dépôt est passé de l'AGPL à Apache puis est revenu en arrière en mars 2026 avant de se stabiliser en avril.
Les niveaux sont un vrai compromis. Flash et Basic tournent sur des CPU ordinaires, et sur une machine sans GPU le niveau Standard n'est activé automatiquement qu'avec 12 cœurs logiques ou plus ; les niveaux avec modèle de vision demandent un GPU, 8 GB de VRAM étant présentés comme un point de départ pour la planification plutôt qu'une garantie. La fiche du modèle annonce 2,12 pages par seconde sur un A100 avec vLLM. Les mainteneurs de Marker ont mesuré l'ancien pipeline de MinerU à 72,7 sur olmOCR-bench et 0,54 page par seconde sur un B200, si bien que les résultats dépendent fortement du niveau et de la version utilisés.
Le projet avance vite. Il y a eu 18 versions entre la 4.0.0 du 16 septembre et la 4.1.4 du 2 novembre, et la 4.1 a cassé l'API HTTP, ce qui oblige à mettre à jour ensemble serveurs, routeurs, SDK et clients. Avec 82 996 étoiles et seulement 11 issues ouvertes, la maintenance est clairement active ; la contrepartie est que figer une version et lire le guide de migration font partie de son exploitation.
Là où il fait la différence
Un ingénieur ML qui construit une recherche documentaire sur 500 000 articles de recherche en chinois et en anglais
Transformer des PDF avec formules et tableaux en Markdown propre
Lancez mineru-kit parse au niveau Standard avec vLLM sur un hôte GPU. Aux 2,12 pages par seconde de la fiche du modèle sur un A100, 5 millions de pages (dix par article) prennent environ 27 jours sur une carte, répartissez donc sur plusieurs GPU avec le Router multiservice.
Une équipe plateforme qui donne aux agents de code l'accès aux documents internes
Permettre aux agents de lire de longs documents page par page et de citer des emplacements exacts
Installez le skill mineru et démarrez la bibliothèque de documents locale ; les agents analysent une fois, puis lisent par identifiants de document, de page et de bloc au lieu de charger des fichiers entiers. Les documents ne sont pas envoyés en ligne sauf si l'analyse distante est configurée.
Une responsable des opérations juridiques dans une entreprise SaaS qui intègre un parseur à son produit
Vérifier la licence avant de livrer MinerU aux clients
Sous les seuils de 100 millions d'utilisateurs et de 20 millions de dollars de chiffre d'affaires mensuel, aucune licence commerciale n'est nécessaire, mais l'interface du produit ou sa documentation publique doit indiquer qu'il utilise MinerU, sans quoi la licence prend fin.
Avant de vous engager
- Mise en route
- Python 3.11 à 3.14 : uv pip install -U "mineru>=4.0,<5", puis mineru-kit parse document.pdf -o document.md --tier standard. Utilisez mineru[full] pour un service NVIDIA à haut débit ; les modèles se téléchargent depuis Hugging Face ou ModelScope.
- Intégrations
- CLI, SDK Python (DoclibClient), API HTTP V1 et Tasks, un Router multiservice, une interface web Gradio, un skill d'agent et une option d'endpoint VLM distant ; neuf formats de sortie dont Markdown, HTML, LaTeX, DOCX et des listes de contenu en JSON.
- Données et confidentialité
- Tourne en local ; la documentation indique que les documents ne sont pas envoyés au service officiel sauf si l'analyse distante est explicitement configurée. Les poids de MinerU2.5-Pro sont sous Apache 2.0 ; la boîte à outils est sous la MinerU Open Source License.
- Coût à grande échelle
- En auto-hébergement, le coût est le matériel : Flash et Basic tournent sur CPU, la documentation conseille au moins 16 GB de mémoire système pour un usage à plus haut débit, et MinerU2.5-Pro a atteint 2,12 pages par seconde sur un A100 avec vLLM.
- Limites
- La sélection automatique du niveau ne vérifie pas la mémoire GPU ; Docker pour les appareils non NVIDIA attend une mise à jour ; les formats Office et web n'utilisent que Flash ; les API HTTP ont changé de façon incompatible dans la 4.1.
Les points forts
- MinerU2.5-Pro obtient 93,22 sur OmniDocBench dans la comparaison d'un concurrent (TII)
- Quatre niveaux, de l'analyse de la couche texte sur CPU à l'analyse par modèle de vision sur GPU
- Formats Office, EPUB, OFD, HTML et CSV analysés nativement
- Très actif : 18 versions entre mi-septembre et début novembre 2026
Les points faibles
- Licence personnalisée avec obligation de mention et seuils de chiffre d'affaires
- OpenDataLab gère aussi OmniDocBench, son benchmark phare
- Changement incompatible de l'API HTTP dans la 4.1
- Le fichier de licence a basculé trois fois entre AGPL et Apache en mars et avril 2026
Idéal pour
Les équipes RAG et data qui analysent sur leur propre matériel de grandes collections mixtes de PDF et de fichiers Office, et qui peuvent accepter une clause de mention.
Alternatives à MinerU
MinerU : questions fréquentes
- MinerU vaut-il le coup ?
- MinerU associe l'un des modèles documentaires ouverts les plus précis à une boîte à outils très active et bien documentée, même si sa licence n'est plus de l'open source pur et que ses API ne cessent de bouger. Nous lui donnons 4.3 sur 5.
- Combien coûte MinerU ?
- Gratuit sous la MinerU Open Source License (Apache 2.0 avec conditions supplémentaires) ; une licence commerciale séparée est exigée au-delà de 100 millions d'utilisateurs actifs mensuels ou de 20 millions de dollars de chiffre d'affaires mensuel.
- Quels sont les inconvénients de MinerU ?
- Licence personnalisée avec obligation de mention et seuils de chiffre d'affaires; openDataLab gère aussi OmniDocBench, son benchmark phare; changement incompatible de l'API HTTP dans la 4.1; le fichier de licence a basculé trois fois entre AGPL et Apache en mars et avril 2026.
- À qui s’adresse MinerU ?
- Les équipes RAG et data qui analysent sur leur propre matériel de grandes collections mixtes de PDF et de fichiers Office, et qui peuvent accepter une clause de mention.
- Combien coûte MinerU pour une équipe ou en production ?
- En auto-hébergement, le coût est le matériel : Flash et Basic tournent sur CPU, la documentation conseille au moins 16 GB de mémoire système pour un usage à plus haut débit, et MinerU2.5-Pro a atteint 2,12 pages par seconde sur un A100 avec vLLM.
- MinerU est-il sûr pour les données de l’entreprise ?
- Tourne en local ; la documentation indique que les documents ne sont pas envoyés au service officiel sauf si l'analyse distante est explicitement configurée. Les poids de MinerU2.5-Pro sont sous Apache 2.0 ; la boîte à outils est sous la MinerU Open Source License.
- Quelles sont les meilleures alternatives à MinerU ?
- Les alternatives les plus proches que nous avons testées sont Docling, Marker et Unstructured.
Réponses vérifiées le 2 nov. 2026.
Vous éditez MinerU ? Affichez cette note sur votre site
