解决 `pip install open-webui` 时的编译错误:Microsoft Visual C++ 14.0 或更高版本缺失

在尝试安装 Python 包 open-webui 时,如果你遇到了如下错误信息:

复制代码
error: subprocess-exited-with-error

× Building wheel for chroma-hnswlib (pyproject.toml) did not run successfully.
│ exit code: 1
╰─> [5 lines of output]
    running bdist_wheel
    running build
    running build_ext
    building 'hnswlib' extension
    error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/
    [end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for chroma-hnswlib
Failed to build chroma-hnswlib
ERROR: Failed to build installable wheels for some pyproject.toml based projects (chroma-hnswlib)

这通常意味着你的系统缺少必要的构建工具,特别是 Microsoft Visual C++ 14.0 或更高版本。下面将详细介绍如何解决这个问题。


解决方案

步骤一:安装 Microsoft Visual C++ 生成工具

  1. 访问 Microsoft C++ Build Tools 官网。
  2. 下载并运行安装程序。
  3. 在安装过程中,请确保勾选"C++ 生成工具"以及适用于你系统的 Windows SDK 版本(例如 Windows 10 SDK)。
  4. 完成安装后,重启计算机以确保所有更改生效。

步骤二:更新 pip 和 setuptools

确保你的 pip 和 setuptools 是最新版本,可以通过以下命令来升级它们:

bash 复制代码
python -m pip install --upgrade pip setuptools

步骤三:重新尝试安装 Open WebUI

现在,再次尝试通过 pip 安装 open-webui:

bash 复制代码
pip install open-webui

替代方案(如果问题依旧存在)

使用预编译的包

有时候,直接从源码编译可能会遇到问题,这时可以尝试强制使用预编译的二进制文件(如果有的话):

bash 复制代码
pip install chroma-hnswlib --only-binary :all:

或者,如果你希望强制源码编译(请确保已正确安装了构建工具):

bash 复制代码
pip install chroma-hnswlib --no-binary :all:

使用 Conda(推荐给已经安装了 Anaconda 或 Miniconda 的用户)

如果你正在使用 Conda 环境管理器,可以通过 Conda Forge 渠道安装 hnswlib:

bash 复制代码
conda install -c conda-forge hnswlib
pip install open-webui

注意事项

  • 确认你所安装的 Visual C++ 版本与你的 Python 架构(32位或64位)相匹配。
  • 运行命令提示符或终端时,最好以管理员权限启动。
  • 如果你在公司网络下工作,并且需要穿过防火墙或代理服务器,请检查你的网络设置是否允许下载所需的资源。
相关推荐
prince_zxill4 小时前
PEP 751 pylock.toml 实测:pip 26.3 装 6 个包版本全钉死,但 [web] 选不中任何东西
python·pip·依赖管理·pep 751
ShineWinsu5 小时前
对于Qt:QFormLayout常见属性以及方法的解析
开发语言·c++·qt·面试·客户端·表单·qformlayout
kyle~6 小时前
嵌入式 SoC 系统
linux·c++·嵌入式·计算系统
奇树谦6 小时前
UML 时序图(Sequence Diagram)详解:从基础概念到实际项目应用
microsoft·uml
爱写Bug的浮游9 小时前
C++移动构造真的比拷贝快吗
c++·性能优化
Aaa西红柿鸡蛋9 小时前
网络协议分析实验:基于 UDP 广播模型的 C/S 通信设计与实现
c++
青少儿编程课堂10 小时前
蓝桥杯·全国青少年信息素养大赛·电子学会Python/C++考级:扫描线与线段树求矩形面积并解析
c++·python·算法·bfs·信息学竞赛
eggwyw1 天前
C++ union 的一种妙用法
开发语言·c++
ShineWinsu1 天前
对于Qt:QHBoxLayout常见属性以及方法的解析
c++·qt·面试·gui·客户端·布局管理器·水平布局器
小七在进步1 天前
string的实现(1)
c++·笔记·visual studio