Docling 在 Python 3.13 下因 numpy 依赖冲突导致安装失败怎么解决？

Docling 在 Python 3.13 下因 numpy 依赖冲突导致安装失败怎么解决【免费下载链接】doclingGet your documents ready for gen AI项目地址: https://gitcode.com/GitHub_Trending/do/docling如果你在用 Poetry 管理的项目里安装 Docling 时pyproject.toml允许 Python 3.13且项目还依赖了把 numpy 锁定在 1.x 的包文档中的案例是 langchain安装会报version solving failed。这是 Docling 项目 FAQ 中记录的真实依赖冲突不是本地环境损坏。解决路径有三条升级到官方支持 Python 3.13 的 Docling 版本、从允许的 Python 版本中移除 3.13、或用环境标记为 numpy 声明分版本约束。选哪条取决于这个项目是否真的要在 Python 3.13 上运行。先确认你遇到的是同一个问题以下是FAQ中给出的文档示例报错该问题最早见于项目 issue #283... Thus, docling (2.7.0,3.0.0) requires numpy (1.26.4,2.0.0). So, because ... depends on both numpy (2.0.2,3.0.0) and docling (^2.7.0), version solving failed.判断依据是报错来自 Poetry 的依赖求解器且冲突双方分别是 docling 对 numpy 的要求和另一个依赖示例中为 numpy2.0.2,3.0.0对 numpy 的要求。FAQ 对根因的说明是numpy 从 2.x 某个版本才开始支持 Python 3.13。旧版 Docling 为了兼容 3.13对 numpy 采取了3.13 用某个 2.x.y、其他版本用 1.x.y的声明方式。当你的pyproject.toml允许 3.13 时Poetry 会尝试把 Docling 在 3.13 下要求的 numpy某个 2.x.y与 LangChain 等依赖要求的 numpy某个 1.x.y同时调和两者互斥于是版本求解失败。方案一升级到官方支持 Python 3.13 的 Docling 版本推荐按 FAQ 的说法Python 3.13 从 Docling 2.18.0 开始得到支持且 Docling 支持的 numpy 版本为1.24.4,3.0.0可以覆盖 numpy 2.x 的使用场景FAQ 同时说明使用docling-ibm-models2.0.7和deepsearch-glm0.26.2时这类问题应该不会再出现。当前仓库的 pyproject.toml 也印证了这一状态requires-python 3.10,4.0convert-coreextra 中声明numpy1.24.0,3.0.0。操作把pyproject.toml中 docling 的版本约束放宽到 2.18.0 及以上或直接移除版本锁定然后重新安装pip install docling使用uv的项目可参考安装文档uv add docling方案二从允许的 Python 版本中移除 3.13如果项目并不实际运行在 Python 3.13 上只是允许范围里带着 3.13最省事的办法是把它排除掉。检查pyproject.toml中的 Python 版本约束若允许了 3.13 就修改后重试。按 FAQ 的示例如果你有python ^3.10改用python 3.10,3.13然后重新执行poetry install。方案三保持 3.9-3.13 兼容用环境标记拆分 numpy 版本如果必须同时兼容旧版和新版 PythonFAQ 针对 3.9-3.13 的兼容需求给出此写法可以在pyproject.toml的依赖声明中加入 FAQ 原文给出的 selectornumpy [ { version ^2.1.0, markers python_version 3.13 }, { version ^1.24.4, markers python_version 3.13 }, ]这样 Python 3.13 环境取^2.1.0分支低于 3.13 的环境取^1.24.4分支避免 Poetry 在求解时要求同一套 numpy 约束同时满足两个互斥的版本区间。验证重新执行安装并确认求解通过三种方案都修改完后重新执行原来的安装命令如poetry install。判定方式与出错时对应不再出现version solving faileddocling 及其依赖正常解析完成。FAQ 对新版本 Docling 的表述是these issues should not show up anymore即问题不再出现即视为解决FAQ 未给出额外的成功日志或数值判定标准验证依赖重跑安装后观察求解器是否完成。适用边界冲突机制对应的是旧版 Docling示例报错中docling (2.7.0,3.0.0)要求 numpy1.26.4,2.0.0。若已升级到官方支持 3.13 的版本方案一即可不必再改 numpy 声明。macOS x86_64 是另一类限制与 Python 3.13 冲突无关但容易混淆FAQ 指出该平台上 PyTorch 在 2.2.2 之后不再提供 macOS x86_64 支持旧版 PyTorch 只兼容 NumPy 1.x必须安装pip install docling numpy2.0.0且安装文档明确提示 PyTorch 2.2.2 要求 Python 3.12 或更低不要在 3.13 上使用该路径。【免费下载链接】doclingGet your documents ready for gen AI项目地址: https://gitcode.com/GitHub_Trending/do/docling创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考