[Pls Help] pip install -r requirements.txt 过程中遇到的问题

[tonyliugd]

大家好！

我这里列出一些“pip install -r requirements.txt 过程中遇到的问题”。
提前感谢大家的帮助。

1. 安装Pillow==9.5.0时遇到下面的告警。
   Collecting Pillow==9.5.0 (from -r requirements.txt (line 42))
   Downloading Pillow-9.5.0.tar.gz (50.5 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 50.5/50.5 MB 27.4 kB/s 0:19:03
   Installing build dependencies ... done
   Getting requirements to build wheel ... error
   error: subprocess-exited-with-error

× Getting requirements to build wheel did not run successfully.
│ exit code: 1
╰─> [24 lines of output]

[tonyliugd]

问题root cause和解决方案是：
建议用 Python 3.9.x 新建虚拟环境，再安装依赖，能保证所有包（包括 Pillow 9.5.0）顺利安装并正常运行。

[dosubot[bot]]

你的分析完全正确：Pillow 9.5.0 与 Python 3.14.x 存在兼容性问题，导致安装失败。BettaFish 项目依赖已在 Python 3.9.x（尤其是 3.9.6）环境下测试，官方也明确推荐用 Python 3.9.x 新建虚拟环境再安装依赖，这样能确保所有包（包括 Pillow 9.5.0）顺利安装和运行，避免类似兼容性报错。参考

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[666ghj]

Agent 自动回复

这里的根因是 Python 3.14 与项目当前锁定的 Pillow==9.5.0 不兼容。旧回复推荐 Python 3.9，但当前 README 的 Conda/uv 示例以及 Docker 镜像均使用 Python 3.11，因此现在建议使用全新的 Python 3.11 虚拟环境重新安装：

uv venv --python 3.11
uv pip install -r requirements.txt

也可使用 Conda 创建 Python 3.11 环境。不要只在现有 Python 3.14 环境中单独升级 Pillow，否则可能破坏项目当前依赖组合。问题原因和当前建议均已明确，本讨论关闭。