Funcionalidades
- Formatos de entrada: PDF, DOCX, PPTX, XLSX, HTML, EPUB e imágenes.
- Formatos de salida: Markdown, HTML, LaTeX, DOCX y EPUB (entre los destinos de exportación citados en el README; según el README, cada CLI/API solo ofrece un subconjunto).
- OCR: modelo para PDFs escaneados e imágenes.
- Fusión de tablas inter-página: las tablas que abarcan varias páginas se reconstruyen como una sola.
- Cajas delimitadoras: coordenadas a nivel de bloque para citas precisas.
- GPU auto-detectada: NVIDIA, AMD, Intel, Apple Silicon; ~2–3× la velocidad de la CPU en cargas de inferencia representativas, según el README.
- Local por defecto: los documentos no se suben por defecto; el análisis remoto requiere configuración explícita.
Instalar MinerU
- Instalación:
pip install mineru - Código fuente: github.com/opendatalab/MinerU (MinerU Open Source License).
Flujo de datos
- Por defecto, el análisis se ejecuta en tu máquina y los documentos no se suben; el análisis remoto requiere configuración explícita. La configuración del análisis local puede requerir descargas de modelos (el README indica aproximadamente 0,8–3 GB según el nivel), por lo que la primera configuración necesita conexión de red.
- El modo cloud/remoto requiere configuración explícita, no es el predeterminado.
- Según el README, el componente Doclib incluye telemetría de uso y diagnóstico (activada al inicio, sin contenido de documentos, texto extraído, nombres de archivo ni consultas de búsqueda); desactívala con
mineru telemetry disableo MINERU_TELEMETRY_DISABLED=1 en el entorno del servidor Doclib. - La organización de GitHub OpenDataLab indica China como ubicación (perfil de GitHub). El servicio alojado en mineru.net enlaza en su pie de página una política de privacidad y un acuerdo de usuario; léelos antes de enviar documentos confidenciales a cualquier modo remoto. El análisis local no sube documentos.
Licencia y precio
- Licencia: MinerU Open Source License, basada en Apache 2.0 con condiciones adicionales (no es la Apache-2.0 estándar). El uso comercial está permitido sin licencia aparte salvo que tú y tus afiliadas superen 100 millones de usuarios activos mensuales o 20 millones de USD de ingresos mensuales totales; los servicios en línea construidos sobre MinerU deben indicar claramente que usan MinerU; si no se cumple, la licencia termina automáticamente. Lee LICENSE.md antes de usarlo comercialmente.
- Precio: la biblioteca se puede descargar y ejecutar en local de forma gratuita; el servicio alojado en mineru.net y su API remota no se evaluaron en cuanto a precios ni límites de uso.
- Los umbrales anteriores proceden de LICENSE.md, que no menciona los pesos de modelos. Los modelos descargados durante la instalación pueden tener sus propias licencias; compruébalas antes de un despliegue comercial.
Competidores y alternativas
- Docling — licencia MIT; iniciado por IBM Research Zurich, alojado por la LF AI & Data Foundation; MCP mediante el paquete independiente docling-mcp.
- Marker — código bajo Apache 2.0, pesos del modelo bajo una licencia AI Pubs Open RAIL-M modificada con límites comerciales (comprueba antes del uso comercial); OCR Surya; Markdown y JSON.
- Unstructured — ETL Python; amplio soporte incluyendo correos.
- OpenDataLoader PDF — analizador solo de PDF con SDK de Python, Node.js y Java; salidas JSON con cajas delimitadoras, Markdown y HTML.
Preguntas frecuentes
¿Es MinerU gratuito para uso comercial?
En gran parte, sí. MinerU usa la MinerU Open Source License (Apache 2.0 con condiciones adicionales). El uso comercial está permitido sin licencia aparte salvo que tú y tus afiliadas superen 100 millones de usuarios activos mensuales o 20 millones de USD de ingresos mensuales totales; los servicios en línea basados en MinerU deben indicar que usan MinerU. Lee LICENSE.md en GitHub.
¿Qué distingue a MinerU de Docling y Marker?
Según su README, MinerU produce LaTeX y fusiona tablas inter-página; consulta la documentación de Docling y Marker para comprobar si ofrecen lo mismo antes de elegir. Docling ofrece compatibilidad con MCP mediante el paquete independiente docling-mcp; Marker usa OCR Surya.
¿MinerU necesita GPU?
No. Funciona en CPU. La GPU se detecta automáticamente en NVIDIA, AMD, Intel y Apple Silicon; el README indica aproximadamente 2–3× la velocidad de la CPU en cargas de inferencia representativas, y la velocidad real depende de tu hardware y del tipo de documento.
¿Cómo instalo MinerU?
pip install mineru en un entorno Python 3.11–3.14.
¿MinerU procesa PDFs escaneados?
Sí. Incluye OCR basada en modelo para documentos escaneados y PDFs imagen.
¿Qué formatos produce MinerU?
Markdown, HTML, LaTeX, DOCX y EPUB (entre los destinos de exportación citados en el README; según el README, cada CLI/API solo ofrece un subconjunto).
¿MinerU tiene servidor MCP?
El README no describe un servidor MCP para v4.2.2. Para MCP, considera Docling (paquete independiente docling-mcp).
¿Quién mantiene MinerU?
OpenDataLab mantiene el repositorio de GitHub.
¿MinerU fusiona tablas inter-página?
Sí. Las tablas que abarcan varias páginas se reconstruyen como una sola en la salida.
¿Cuál es la versión actual?
v4.2.2, lanzada el 13 de noviembre de 2026 (GitHub Releases). Verificado el 15 de noviembre de 2026.
Fuentes
- github.com/opendatalab/MinerU (consultado 2026-11-15).
- opendatalab.com (consultado 2026-11-15).
