MinerU 文档解析：离线部署 实战手册

MinerU 文档解析：离线部署 实战手册

【免费下载链接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.项目地址: https://gitcode.com/GitHub_Trending/mi/MinerU

处理一份 40 页的扫描版合同，传统 OCR 管线平均要跑 6 分钟，公式和表格还容易丢失。MinerU 文档解析工具将 PDF、扫描件与 Office 文档转为结构化的 Markdown 与 JSON。读完本文，你可以在 GPU 机器、纯 CPU 机器或远程推理环境中独立完成安装，并跑通首次文档转换。

安装并跑通首个文档转换

MinerU 文档解析在任意机器上都能走通最小路径，步骤如下。

uv pip install "mineru[all]" mineru -p ./demo.pdf -o ./output

-p指输入文件或目录，-o指输出目录。首次运行会自动下载所需模型；国内网络访问 huggingface 不稳定时，将MINERU_MODEL_SOURCE设为modelscope切换到国内镜像源。运行结束后，输出目录中按文档名生成子目录，内含 Markdown、content_list.json与提取的图片。

按使用场景选择解析配置

GPU 机器启用高精度解析

适用条件：拥有 NVIDIA GPU（显存 8GB 起步）或 Apple Silicon，本机直接推理。启用方式：默认后端即hybrid-engine，安装mineru[all]后无需额外配置。效果指标：按官方快速入门给出的 OmniDocBench v1.6 基准，端到端 Overall 得分从 86.47 升至 95.39（high 强度）。

纯 CPU 机器启用离线解析

适用条件：服务器或内网终端没有可用显卡。启用方式：在命令中追加-b pipeline，走纯 CPU 的小模型组合。效果指标：完全离线即可产出结果，首次运行配置MINERU_MODEL_SOURCE后模型来自国内源，完成 MinerU 离线部署。

边缘设备连接远程推理服务

适用条件：本机显存不足（2GB 以下），但网络可达一台 OpenAI 兼容的推理服务（如 vLLM、SGLang 部署的端点）。启用方式：安装轻量客户端包mineru，用vlm-http-client或hybrid-http-client后端并通过--url传入服务地址。效果指标：本机不再加载大模型，显存需求从 8GB 降到 2GB 量级。

速查解析关键参数

排查部署与运行故障

延伸阅读

• 快速入门 —— 安装方式、软硬件支持矩阵与后端精度基准
• 命令行工具环境变量说明 —— 全部环境变量与 CLI 参数定义
• 常见问题 FAQ —— 安装与运行期高频故障的处理方案

【免费下载链接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.项目地址: https://gitcode.com/GitHub_Trending/mi/MinerU