MinerU Python 3.10–3.13 兼容指南两条命令跑通文档解析环境【免费下载链接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.项目地址: https://gitcode.com/GitHub_Trending/mi/MinerUMinerU 是一个把 PDF 和 Office 文档解析成 Markdown / JSON 的开源工具它对 Python 3.10–3.13 四个版本全部兼容你不用再为不同机器上的 Python 版本重新折腾依赖。下面讲清楚版本范围是怎么声明的、依赖怎么按模块拆分以及按场景该怎么选版本。快速上手在任意 Python 3.10 的机器上先装包再解析一份文档pip install -U mineru[all] mineru -p demo/pdfs/demo1.pdf -o ./output首次运行会自动下载所需的模型文件后续直接读本地缓存。设备没有 GPU 的话第二条命令加上-b pipeline用纯 CPU 跑 pipeline 后端即可。mineru[all]打包了 vlm、pipeline 和 Gradio WebUI如果你只是想连接已有的 OpenAI 兼容模型服务装裸mineru轻量客户端就够了。它是怎么实现的兼容能力来自pyproject.toml里三层声明而不是运行时打补丁版本区间requires-python 3.10,3.14。pip 在 3.9 或 3.14 上会直接拒绝安装失败信息明确不会装到一半再报莫名其妙的错。分类器声明classifiers 里逐条列出 3.10、3.11、3.12、3.13包页面会据此展示目标版本也方便下游工具做环境检查。可选依赖分组torch2.6.0、transformers4.57.3这类重量级模型依赖放在vlm/pipeline/vllm/lmdeploy分组下基础包只保留 click、numpy、pillow 等轻依赖。[all]再按操作系统自动扩展——Linux 装 vllm、macOS 装 mlx、Windows 装 lmdeploy一台机器只会拉进自己平台用得到的推理框架。requires-python 3.10,3.14 classifiers [ Programming Language :: Python :: 3.10, Programming Language :: Python :: 3.13, ]安装命令装到什么pip install mineru轻量 client连接远端模型服务pip install mineru[core]vlm pipeline gradio本地推理pip install mineru[all]core s3 平台对应的推理框架按场景选方案个人开发机无 GPUPython 3.11 pip install mineru[core]运行时带-b pipeline。pipeline 后端对硬件要求最低CPU 也能跑适合日常调试解析效果。Linux 生产服务器pip install mineru[all]。Linux 平台会自动带上 vllm适合 GPU 加速的批量解析模型默认从 huggingface 拉取内网机器先执行export MINERU_MODEL_SOURCEmodelscope切换模型源再解析。Windows 开发机选 Python 3.10–3.12。由于 ray 这个关键依赖在 Windows 上尚未支持 3.13Windows 侧的可用范围到 3.12 为止。边缘 / 低配机器装裸pip install mineru轻量 client通过兼容 OpenAI API 的服务调用解析能力磁盘占用最低档约 2GB不需要本地模型。系统层面注意官方支持 2019 年及以后的 Linux 发行版和 macOS 14.0 以上更老的 Linux如 CentOS 7已不在支持范围内。踩坑提醒现象pip 安装时报requires Python 3.10,3.14。→ 修复uv venv --python 3.11 uv pip install -U mineru[all]把环境切进支持区间。现象首次解析时模型下载卡住或报错huggingface 不可达。→ 修复export MINERU_MODEL_SOURCEmodelscope后重跑。现象Windows 上用了 3.13GPU 相关依赖装不齐或 ray 安装失败。→ 修复改用 3.11 / 3.12 重建环境如uv venv --python 3.12。怎么选生产服务器建议 Python 3.11它在 torch、transformers 等第三方库的兼容记录最久出问题最少开发机可以用 3.12更早用上改进的错误信息和新语法两者在 MinerU 里的行为一致。版本范围与依赖分组的完整定义见 pyproject.toml安装与部署的详细流程见 docs/zh/quick_start/index.md。【免费下载链接】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），仅供参考