解决Boltz项目安装过程中scipy依赖OpenBLAS报错问题

问题背景

在安装Boltz项目时，用户遇到了一个常见的Python包依赖问题。具体表现为在安装过程中，scipy包的构建失败，错误信息显示无法找到OpenBLAS依赖。这是一个典型的科学计算Python包安装问题，涉及到底层数学库的依赖关系。

错误分析

从错误日志中可以看到，关键错误信息是：

ERROR: Dependency "OpenBLAS" not found, tried pkgconfig

这表明系统缺少OpenBLAS数学库，而scipy在构建时需要这个库。OpenBLAS是一个高性能的线性代数库，许多科学计算包都依赖它。在Linux系统上，这类底层依赖通常需要通过系统包管理器安装。

解决方案

经过多次尝试，最终找到了有效的解决方案。以下是完整的解决步骤：

1. 创建新的conda环境：使用Python 3.9.7版本创建环境，避免使用过新或过旧的Python版本可能带来的兼容性问题。

   conda create --name protein_boltz1 python=3.9.7
   conda activate protein_boltz1
   

2. 安装cmake：cmake是构建工具，许多科学计算包需要它。

   conda install cmake
   

3. 设置环境变量：确保cmake能够被正确找到。

   export CMAKE_PREFIX_PATH=/opt/.miniconda/envs/protein_boltz1/
   

4. 单独安装scipy：先安装指定版本的scipy，解决其依赖问题。

   conda install scipy==1.13.1
   

5. 安装Boltz项目：最后安装Boltz项目。

   pip install boltz -U
   

技术原理

这个问题的根本原因在于：

1. Python包依赖关系：Boltz项目依赖scipy，而scipy又依赖OpenBLAS这样的底层数学库。

2. 构建工具链：现代Python科学计算包通常使用meson或cmake等构建系统，这些系统需要正确配置才能找到系统依赖。

3. 环境隔离：使用conda环境可以更好地管理Python版本和依赖关系，避免系统Python环境被污染。

经验总结

1. Python版本选择：对于科学计算项目，Python 3.9.x通常是一个稳定且兼容性好的选择。

2. 依赖管理：遇到构建问题时，可以尝试先单独安装有问题的依赖包。

3. 构建工具：确保系统中有完整的构建工具链（如cmake、gcc等）。

4. 环境变量：正确设置构建相关的环境变量有时能解决找不到依赖的问题。

通过这种方法，我们不仅解决了Boltz项目的安装问题，也为处理类似的科学计算Python包安装问题提供了参考方案。