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 文档转成 LLM 可直接使用的 Markdown 与 JSON 的解析工具本文从新手角度讲清它的 Python 版本兼容问题3.10–3.13 全部官方支持怎么选版本、怎么一次装对。生产环境选哪个 Python 版本Python 版本支持状态适用场景3.10✅ 支持旧系统生产环境、已锁定 3.10 的存量项目3.11✅ 支持生产首选第三方库兼容性最好3.12✅ 支持日常开发测试新特性、报错信息更清晰3.13✅ 支持尝鲜与新项目试验个别重型依赖仍在跟进懒人结论生产直接用 3.11尝鲜用 3.13只要落在 3.10–3.13 之间都能装能跑。一条命令级路径装好 MinerU用 Conda 建隔离环境三步走完conda create -n mineru python3.11 -y conda activate mineru pip install -U mineru[core]装完即可用。mineru[core]已捆绑 VLM、pipeline 解析与 Gradio 可视界面只要命令行能力则装基础包即可CLI 参数细节可查docs/zh/usage/cli_tools.md。偏好容器化部署的话docker/目录已备好现成的 Dockerfile 与 compose 配置拉镜像直接运行。兼容原理一句话讲清兼容不是碰运气靠两个机制pyproject.toml里用requires-python 3.10,3.14声明版本范围范围外的 pip 会直接拒装避免装上了却跑不起来的鬼影安装各功能模块的依赖再拆成[core]、[pipeline]、[vlm]等 extras由安装工具按实际 Python 自动解析版本。典型写法是tomli; python_version 3.11这类版本条件3.10 环境自动补装兼容包3.11 自动跳过。依赖声明里散布着这种按版本分叉的规则所以跨版本安装不需要手工调包。上图是 MinerU 的分层架构预处理、模型层、管线层、输出层与质检层。解析逻辑与 Python 版本无关四个版本上行为完全一致变的只是依赖的解析方式。避坑指南四个常见报错装的时候直接报 requires Python 3.10,3.14当前环境是 3.9 或 3.14切到范围内版本重装即可。torch、vllm 等依赖冲突它们来自 vlm/vllm 类 extras体量大且版本敏感。纯 CPU 机器只装mineru[core]GPU 机器按需装对应 extras 并让解析器一次算完别手工锁版本。中文缺字、字体报错Linux 先装 Noto CJK 字体fonts-noto-cjk否则中文 PDF 渲染会出乱码。本地能跑、服务器跑挂多半是两边 Python 版本不一致导致依赖解析结果不同统一同一小版本并固定 mineru 版本号。收尾MinerU 的跨版本兼容本质就是一句话范围声明清楚、依赖按版本自适应3.10–3.13 任选一个都能放心用。下一步动作照上面的命令建好 3.11 环境丢一份 PDF 跑一遍mineru看看 Markdown 输出 【免费下载链接】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），仅供参考