Python中无法安装llama-cpp-python包：Wheel构建进程卡住

可行解决方案 #

1. 补全编译依赖库 #

llama-cpp-python构建需要依赖系统级编译工具和数学库，Ubuntu 22.04下先安装以下基础依赖：

sudo apt update
sudo apt install build-essential cmake libopenblas-dev libssl-dev

安装完成后重新执行：

pip3 install llama-cpp-python

2. 强制使用预编译Wheel包 #

跳过本地编译，直接使用PyPI提供的预编译包，适合x86_64架构的Ubuntu系统：

CMAKE_ARGS="-DLLAMA_BLAS=ON -DLLAMA_BLAS_VENDOR=OpenBLAS" pip3 install llama-cpp-python --only-binary :all:

3. 限制编译并行任务数 #

默认并行编译可能导致资源调度异常，手动设置make的进程数（比如保留2个核心不占用）：

CMAKE_ARGS="-DLLAMA_BLAS=ON -DLLAMA_BLAS_VENDOR=OpenBLAS" MAKEFLAGS="-j$(nproc --ignore=2)" pip3 install llama-cpp-python

4. 手动指定llama.cpp源码路径 #

如果构建时拉取源码网络不稳定，先手动克隆仓库再指定路径安装：

git clone https://github.com/ggerganov/llama.cpp.git
CMAKE_ARGS="-DLLAMA_CPP_DIR=$(pwd)/llama.cpp" pip3 install llama-cpp-python

内容的提问来源于stack exchange，提问作者Illanser