功能
- 输入格式: PDF、DOCX、PPTX、XLSX、HTML、EPUB 及常见图片格式。
- 输出格式: Markdown(默认)、HTML、LaTeX、DOCX 和 EPUB(为 README 所列导出目标中的一部分;README 称各 CLI/API 仅提供其中一个子集)。
- OCR: 模型驱动的 OCR,处理扫描文档。
- 跨页表格合并: 跨多页的表格被检测并合并为单个表格。
- 边界框: 块级坐标,可用于精确引用。
- GPU 自动检测: NVIDIA/AMD/Intel/Apple Silicon,README 称在代表性推理工作负载上约快 2–3 倍。
- 默认本地: 默认不上传文档,远程解析需要显式配置。
安装
- 安装:
pip install mineru - Python: 3.11、3.12、3.13 或 3.14。
- 源码: github.com/opendatalab/MinerU(MinerU Open Source License)。
数据流向
- 默认情况下解析在本机进行,文档不会被上传;远程解析需要显式配置。本地解析的设置可能需要下载模型(README 列出的大小因档位而异,约 0.8–3 GB),因此首次设置需要网络连接。
- 远程/云模式需要显式配置,并非默认。
- README 称 Doclib 组件包含使用情况和诊断遥测(初始启用,不含文档内容、提取的文本、文件名和搜索查询);可通过
mineru telemetry disable或在 Doclib 服务器环境中设置 MINERU_TELEMETRY_DISABLED=1 关闭。 - OpenDataLab 的 GitHub 组织页面将所在地列为中国(GitHub 个人资料)。托管服务 mineru.net 在页脚链接了隐私政策和用户协议;向任何远程模式发送机密文档前请先阅读。本地解析不会上传文档。
许可证与价格
- 许可证: MinerU Open Source License,基于 Apache 2.0 并附加条款(不是标准的 Apache-2.0)。除非您及关联方的月活跃用户超过 1 亿,或月总收入超过 2000 万美元,否则无需单独许可即可商用;基于 MinerU 构建的在线服务必须明确标明使用了 MinerU;违反条款时许可自动终止。商用前请阅读 LICENSE.md。
- 价格: 该库可免费下载并在本地运行;托管服务 mineru.net 及其远程 API 的定价和使用限制未作评估。
- 上述阈值来自 LICENSE.md,其中未提及模型权重。安装时下载的模型可能适用各自的许可证;商用部署前请逐一核实。
竞品与替代方案
- Docling — MIT 许可;由 IBM Research Zurich 发起,由 LF AI & Data Foundation 托管;MCP 通过独立软件包 docling-mcp 提供。
- Marker — 代码采用 Apache 2.0,模型权重采用带商用限制的修改版 AI Pubs Open RAIL-M 许可(商用前请核实);Surya OCR;Markdown 和含边界框的 JSON。
- Unstructured — Python ETL;支持邮件等广泛格式。
- OpenDataLoader PDF — 仅 PDF 的解析器,提供 Python、Node.js 和 Java SDK;输出含边界框的 JSON、Markdown 和 HTML。
常见问题
MinerU 可以免费商用吗?
基本可以。MinerU 采用 MinerU Open Source License(Apache 2.0 加附加条款)。除非您及关联方的月活跃用户超过 1 亿,或月总收入超过 2000 万美元,否则无需单独许可即可商用;基于 MinerU 构建的在线服务必须明确标明使用了 MinerU。请阅读 GitHub 上的 LICENSE.md。
MinerU 与 Docling、Marker 的区别是什么?
MinerU 的 README 记载了 LaTeX 输出和跨页表格合并;选择前请查阅 Docling 和 Marker 的文档,确认是否具备相同功能。Docling 通过独立软件包 docling-mcp 提供 MCP 支持;Marker 使用 Surya OCR。
MinerU 需要 GPU 吗?
不需要。MinerU 可在 CPU 上运行。GPU 会被自动检测;README 称在代表性推理工作负载上约为 CPU 速度的 2–3 倍,实际速度取决于您的硬件和文档类型。
如何安装 MinerU?
在 Python 3.11–3.14 环境中运行 pip install mineru,推荐使用虚拟环境。
MinerU 支持扫描 PDF 吗?
支持。MinerU 包含模型驱动的 OCR,可处理扫描文档和图片 PDF。
MinerU 支持哪些输出格式?
Markdown(默认)、HTML、LaTeX、DOCX 和 EPUB(为 README 所列导出目标中的一部分;README 称各 CLI/API 仅提供其中一个子集)。
MinerU 有 MCP 服务器吗?
README 未描述 v4.2.2 的 MCP 服务器。需要 MCP 集成时请考虑 Docling(独立软件包 docling-mcp)。
谁维护 MinerU?
OpenDataLab 维护 GitHub 仓库。
MinerU 能合并跨页表格吗?
能。跨多页的表格会被检测并合并为单个表格(README 记录功能)。
当前版本是什么?
v4.2.2,2026 年 11 月 13 日发布(GitHub Releases),2026 年 11 月 15 日确认。
参考资料
- github.com/opendatalab/MinerU(2026-11-15 查阅)。
- opendatalab.com(2026-11-15 查阅)。
