MinerU PDF 转换指南如何按需组合模块并完成 GPU 加速配置【免费下载链接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.项目地址: https://gitcode.com/GitHub_Trending/mi/MinerU把上百页的扫描件变成结构化的 Markdown是搭建 RAG 知识库和 Agent 工作流绕不开的一步。MinerU 负责把 PDF、Office 文档解析成 LLM 可直接消费的 Markdown 与 JSON它的扩展模块按需安装不必全都要。这篇教程带你完成三件事选对安装包、跑通第一次 PDF 转换、配好 GPU 加速。第一步选安装包先按机器配置做决策MinerU 的可选安装组把功能拆成了几档装多装少取决于你手头的硬件。先看结论安装组合适用人群特点mineru基础包只做转换调用的轻量机器体积最小把解析任务交给远端服务mineru[core]需要在本地完成全部转换的用户除 vllm 外的核心组件装完即可用mineru命令mineru[all]有 GPU 且追求吞吐的用户等价于mineru[core,vllm]包含全部扩展 选型口诀没有 GPU 或机器配置低选基础包走远程要本地完整转换选 coreGPU 够强想加速直接 all。三行命令跑通首次转换安装到出结果的最短路径选定 core 后下面三条命令就是从空环境到拿到输出物的完整链路。安装 core 组件uv pip install mineru[core]对一份 PDF 发起转换-p指输入文件-o指输出目录mineru -p demo.pdf -o output运行结束后output目录下会生成解析出的 Markdown、图片与中间 JSON 结果可以直接喂给下游的 LLM 流程。完整的参数清单分页解析、公式/表格开关等可查阅 CLI 工具文档。给 GPU 换上加速引擎vllm 模块的安装与门槛vllm 模块面向 GPU 用户前提条件是 Turing 架构及以上显卡且显存 8G 起步。满足后一条命令即可装齐全部扩展uv pip install mineru[all]然后配置两个环境变量设备模式指定为 cuda虚拟显存大小按实际卡调整export MINERU_DEVICE_MODEcuda export MINERU_VIRTUAL_VRAM_SIZE16原理一句话带过vllm 借助 PagedAttention一种把 KV 缓存分页管理的技术避免显存碎片化让批量推理更快更省整体推理速度有显著提升。相关模型代码位于 mineru/model/vlm 目录。连上远程推理服务轻量客户端用法本地没有 GPU 但有一台服务器时基础包就是最合适的选择它体积最小把重活交给远端。客户端通过 HTTP 连接 vllm-server一条命令即可发起转换mineru --backend vlm-http-client -u http://server-ip:8000 -p input.pdf -o output.md其中-u指向远端的 OpenAI 兼容服务地址适合边缘设备与多机分摊解析压力的部署形态。环境变量速查表不碰代码调节行为不想每次都在命令行里堆参数时环境变量更省事且通常优先于命令行参数生效。变量名作用示例值MINERU_MODEL_SOURCE切换模型下载来源modelscopeMINERU_FORMULA_ENABLE公式解析开关falseMINERU_TABLE_ENABLE表格识别开关true例如国内网络下载模型不便时把来源切成 modelscope 即可纯文字文档可以关掉公式与表格解析来省时间。全部变量的说明见 环境变量说明。高频问题自查现象、原因与一行修复现象vllm 安装失败或环境不兼容。原因vllm 对显卡驱动与 CUDA 版本有硬性要求手搓依赖容易踩坑。修复直接使用官方 Docker 预构建镜像参考 Docker 部署指南。现象转换结果中文显示为乱码。原因解析时语言识别不准OCR 按错误字符集还原了文字。修复在运行转换时通过-l ch显式指定文档语言该参数仅 pipeline 后端生效。现象推理时报显存不足。原因批量处理占用的显存超出了卡的实际容量。修复调小MINERU_VIRTUAL_VRAM_SIZE的取值为系统留出余量。小结与延伸阅读MinerU 把 PDF 转换拆成了基础包、core、all 三档安装组分别对应远程调用、本地转换与 GPU 加速三种形态配合环境变量即可覆盖多数场景。完整代码与更多示例可在 MinerU 仓库 找到。延伸阅读常见问题 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考