MinerU

环境要求

• Python 3.10-3.13（Windows 因 ray 依赖限制仅支持 3.10~3.12）
• 内存最低 16GB，推荐 32GB 以上；磁盘最低 20GB，建议 SSD
• GPU 需 Volta 及以后架构或 Apple Silicon；pipeline 后端纯 CPU 也可运行
• 操作系统：Linux（2019 年后发行版）/ Windows / macOS 14.0 以上
• Docker 部署仅支持 Linux 和支持 WSL2 的 Windows，macOS 请勿使用 Docker

安装与启动步骤

1. 1确认环境达标

   先核对系统版本、Python 版本、内存与磁盘空间是否满足上表要求，并建议先用在线演示评估解析质量再决定部署方式。

2. 2安装 pip 与 uv

   升级 pip 并安装 uv 包管理器，后续用 uv 安装 MinerU 及其全部依赖。

   pip install --upgrade pip
   pip install uv

   复制

3. 3安装 MinerU

   安装 mineru[all]，包含全部核心功能，兼容 Windows / Linux / macOS，适合大多数用户。

   uv pip install -U "mineru[all]"

   复制

4. 4源码方式安装

   如需从源码安装，克隆仓库后进入目录，用 uv 以可编辑模式安装全部依赖。与上一步二选一即可。

   git clone https://github.com/opendatalab/MinerU.git
   cd MinerU
   uv pip install -e .[all]

   复制

5. 5Docker 部署(可选)

   仅 Linux 与支持 WSL2 的 Windows 可用；README 未给出具体命令，请按官方 Docker 部署文档操作，macOS 请改用前两种方式。

如何确认成功

安装过程无报错，可用 pip show mineru 看到已安装版本号即表示安装成功；解析效果请按官方文档实测。

常见问题

注意事项

• mineru[all] 包含全部核心功能，适合绝大多数用户；如需指定 VLM 推理框架请查阅扩展模块安装指南。
• -engine 系列后端对硬件要求更高，hybrid/vlm 需 8GB 以上显存且不支持纯 CPU；-http-client 系列面向兼容 OpenAI 的服务器。
• Docker 部署命令 README 未直接给出，请以官方《Docker Deployment Instructions》文档为准。
• 遇到安装问题先查官方 FAQ，多数兼容性问题已有对应解决方案。