尧图网站建设 
MinerU Python 3.10-3.13 全版本兼容3 种安装方式 10 分钟跑通【免费下载链接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.项目地址: https://gitcode.com/GitHub_Trending/mi/MinerU本地开发机跑着 3.11CI 上却是 3.12一换环境mineru就装不上或依赖打架这是文档解析类项目最常见的翻车现场。MinerU 是把 PDF、图片、DOCX/PPTX/XLSX 解析成 Markdown/JSON 的工具当前版本 3.4.4官方明确支持 Python 3.10 到 3.13 共 4 个版本。看完本文你可以知道每个版本装什么、装完怎么验证、哪些坑已经有人踩过。先说结论TL;DR支持 Python 3.10 / 3.11 / 3.12 / 3.13 共 4 个版本Windows 上因依赖限制只到 3.12。一条命令装全功能uv pip install -U mineru[all]轻量场景用mineru[core]。版本门槛写死在requires-python 3.10,3.143.9 或 3.14 会在安装阶段直接报错不会装到一半才炸。纯 CPU 环境加-b pipeline就能跑首次运行自动下载模型Hugging Face 不通就设MINERU_MODEL_SOURCEmodelscope。环境要求速查Python 版本一句话评价适用场景3.10兼容下限第三方库适配最宽生产环境3.11性能与兼容性平衡最好推荐默认选择3.12错误信息更详细调试友好开发/测试环境3.13最新特性但 Windows 不支持Linux/macOS 尝鲜另外两个硬门槛Linux 需 2019 年及以后发行版macOS 需 14.0 以上不满足的环境不建议折腾。动手配置方式一uv 或 pip 直接安装适合绝大多数场景实测在 3.11 上装mineru[all]约 2~5 分钟取决于网络。uv pip install -U mineru[all] # 或者 pip install -U mineru[all] # 不需要 vllm / lmdeploy / s3 时装轻量的 core 即可 uv pip install mineru[core]方式二源码安装方便改代码调试。git clone https://gitcode.com/GitHub_Trending/mi/MinerU cd MinerU uv pip install -e .[all]方式三Docker 部署只适用于 Linux 和支持 WSL2 的 WindowsmacOS 不要用容器里调不到 MPS/MLX 加速。docker compose -f docker/compose.yaml --profile api up -d装完验证一下纯 CPU 环境指定pipeline后端即可mineru -p demo/pdfs/demo1.pdf -o out -b pipeline输出目录里能看到生成的 Markdown 和图片说明环境已跑通。它为什么能做到原理揭秘用版本范围把边界画死pyproject.toml里直接声明requires-python 3.10,3.14pip 在解析依赖前就会做这个检查 → 所以 3.9、3.14 环境会在安装第一步被拦下报错信息明确指向 Python 版本而不是等到某个 wheel 装不上才发现。用 classifiers 声明 4 版本矩阵classifiers [ Programming Language :: Python :: 3.10, Programming Language :: Python :: 3.11, Programming Language :: Python :: 3.12, Programming Language :: Python :: 3.13, ]这组元数据发布到 PyPI 后支持范围一目了然 → 用户不用翻 issue 去猜到底支不支持 3.13。按平台自动挑加速引擎[all]这个扩展包是这样拼的all [ mineru[core], mineru[s3], mineru[mlx] ; sys_platform darwin, mineru[vllm] ; sys_platform linux, mineru[lmdeploy] ; sys_platform win32, ]同一条安装命令在 macOS 装 MLX、Linux 装 vllm、Windows 装 lmdeploy → 三种系统的推理加速引擎自动就位不用手动挑 wheel。这也是 Windows 只到 3.12 的原因lmdeploy 依赖链里的ray尚未提供 Windows Python 3.13 的包。踩坑与排错坑 1Linux/WSL2 上 import 报ImportError: libGL.so.1症状mineru -p ...一启动就抛libGL.so.1: cannot open shared object file。原因opencv 这个核心依赖需要系统级 libgl最小化系统和 WSL2 默认没装。解决sudo apt-get install libgl1-mesa-glx坑 2解析结果中文缺字症状输出 Markdown 正常但渲染出的图片里部分汉字是空白。原因MinerU 2.0 起用 pypdfium2 渲染 PDF发行版缺 CJK 字体时中文会丢。解决sudo apt update sudo apt install fonts-noto-core fonts-noto-cjk fc-cache -fv用 Docker 部署的话镜像里已自带这些字体可以绕开这个问题。坑 3Windows Python 3.13 装完跑不了 GPU 加速症状3.13 环境安装成功但 vlm 加速相关依赖报错或回退到 CPU。原因ray不支持 Windows 上的 3.13官方 Windows 上限就是 3.12。解决降级环境而不是硬装conda create -n mineru python3.12 -y conda activate mineru uv pip install -U mineru[all]进阶技巧调渲染和线程参数。PDF 渲染默认 3 个线程、300 秒超时高并发服务化部署时容易抢 CPU用环境变量压一压export MINERU_PDF_RENDER_THREADS4 export MINERU_PDF_RENDER_TIMEOUT600 export MINERU_INTRA_OP_NUM_THREADS4 export MINERU_INTER_OP_NUM_THREADS2CI 里跑 4 版本矩阵。确认代码在全部支持版本可用配置很短jobs: test: strategy: matrix: python-version: [3.10, 3.11, 3.12, 3.13] steps: - uses: actions/setup-pythonv4 with: python-version: ${{ matrix.python-version }} - run: pip install -e .[test] - run: pytest tests/一句话收尾挑一个你环境里最容易出问题的 Python 版本现在跑一条uv pip install -U mineru[all]加验证命令装不上再来对一遍上面三个坑。【免费下载链接】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），仅供参考 MinerU Python 3.10-3.13 全版本兼容：3 种安装方式 10 分钟跑通
MinerU Python 3.10-3.13 全版本兼容3 种安装方式 10 分钟跑通【免费下载链接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.项目地址: https://gitcode.com/GitHub_Trending/mi/MinerU本地开发机跑着 3.11CI 上却是 3.12一换环境mineru就装不上或依赖打架这是文档解析类项目最常见的翻车现场。MinerU 是把 PDF、图片、DOCX/PPTX/XLSX 解析成 Markdown/JSON 的工具当前版本 3.4.4官方明确支持 Python 3.10 到 3.13 共 4 个版本。看完本文你可以知道每个版本装什么、装完怎么验证、哪些坑已经有人踩过。先说结论TL;DR支持 Python 3.10 / 3.11 / 3.12 / 3.13 共 4 个版本Windows 上因依赖限制只到 3.12。一条命令装全功能uv pip install -U mineru[all]轻量场景用mineru[core]。版本门槛写死在requires-python 3.10,3.143.9 或 3.14 会在安装阶段直接报错不会装到一半才炸。纯 CPU 环境加-b pipeline就能跑首次运行自动下载模型Hugging Face 不通就设MINERU_MODEL_SOURCEmodelscope。环境要求速查Python 版本一句话评价适用场景3.10兼容下限第三方库适配最宽生产环境3.11性能与兼容性平衡最好推荐默认选择3.12错误信息更详细调试友好开发/测试环境3.13最新特性但 Windows 不支持Linux/macOS 尝鲜另外两个硬门槛Linux 需 2019 年及以后发行版macOS 需 14.0 以上不满足的环境不建议折腾。动手配置方式一uv 或 pip 直接安装适合绝大多数场景实测在 3.11 上装mineru[all]约 2~5 分钟取决于网络。uv pip install -U mineru[all] # 或者 pip install -U mineru[all] # 不需要 vllm / lmdeploy / s3 时装轻量的 core 即可 uv pip install mineru[core]方式二源码安装方便改代码调试。git clone https://gitcode.com/GitHub_Trending/mi/MinerU cd MinerU uv pip install -e .[all]方式三Docker 部署只适用于 Linux 和支持 WSL2 的 WindowsmacOS 不要用容器里调不到 MPS/MLX 加速。docker compose -f docker/compose.yaml --profile api up -d装完验证一下纯 CPU 环境指定pipeline后端即可mineru -p demo/pdfs/demo1.pdf -o out -b pipeline输出目录里能看到生成的 Markdown 和图片说明环境已跑通。它为什么能做到原理揭秘用版本范围把边界画死pyproject.toml里直接声明requires-python 3.10,3.14pip 在解析依赖前就会做这个检查 → 所以 3.9、3.14 环境会在安装第一步被拦下报错信息明确指向 Python 版本而不是等到某个 wheel 装不上才发现。用 classifiers 声明 4 版本矩阵classifiers [ Programming Language :: Python :: 3.10, Programming Language :: Python :: 3.11, Programming Language :: Python :: 3.12, Programming Language :: Python :: 3.13, ]这组元数据发布到 PyPI 后支持范围一目了然 → 用户不用翻 issue 去猜到底支不支持 3.13。按平台自动挑加速引擎[all]这个扩展包是这样拼的all [ mineru[core], mineru[s3], mineru[mlx] ; sys_platform darwin, mineru[vllm] ; sys_platform linux, mineru[lmdeploy] ; sys_platform win32, ]同一条安装命令在 macOS 装 MLX、Linux 装 vllm、Windows 装 lmdeploy → 三种系统的推理加速引擎自动就位不用手动挑 wheel。这也是 Windows 只到 3.12 的原因lmdeploy 依赖链里的ray尚未提供 Windows Python 3.13 的包。踩坑与排错坑 1Linux/WSL2 上 import 报ImportError: libGL.so.1症状mineru -p ...一启动就抛libGL.so.1: cannot open shared object file。原因opencv 这个核心依赖需要系统级 libgl最小化系统和 WSL2 默认没装。解决sudo apt-get install libgl1-mesa-glx坑 2解析结果中文缺字症状输出 Markdown 正常但渲染出的图片里部分汉字是空白。原因MinerU 2.0 起用 pypdfium2 渲染 PDF发行版缺 CJK 字体时中文会丢。解决sudo apt update sudo apt install fonts-noto-core fonts-noto-cjk fc-cache -fv用 Docker 部署的话镜像里已自带这些字体可以绕开这个问题。坑 3Windows Python 3.13 装完跑不了 GPU 加速症状3.13 环境安装成功但 vlm 加速相关依赖报错或回退到 CPU。原因ray不支持 Windows 上的 3.13官方 Windows 上限就是 3.12。解决降级环境而不是硬装conda create -n mineru python3.12 -y conda activate mineru uv pip install -U mineru[all]进阶技巧调渲染和线程参数。PDF 渲染默认 3 个线程、300 秒超时高并发服务化部署时容易抢 CPU用环境变量压一压export MINERU_PDF_RENDER_THREADS4 export MINERU_PDF_RENDER_TIMEOUT600 export MINERU_INTRA_OP_NUM_THREADS4 export MINERU_INTER_OP_NUM_THREADS2CI 里跑 4 版本矩阵。确认代码在全部支持版本可用配置很短jobs: test: strategy: matrix: python-version: [3.10, 3.11, 3.12, 3.13] steps: - uses: actions/setup-pythonv4 with: python-version: ${{ matrix.python-version }} - run: pip install -e .[test] - run: pytest tests/一句话收尾挑一个你环境里最容易出问题的 Python 版本现在跑一条uv pip install -U mineru[all]加验证命令装不上再来对一遍上面三个坑。【免费下载链接】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），仅供参考