skip to content
声控烤箱 | KazooTTT 博客

pip安装和运行openwebui

Updated:

运行 openwebui 的时候除了 docker 部署之外,还有一种方法是 pip 部署

GitHub - open-webui/open-webui: User-friendly AI Interface (Supports Ollama, OpenAI API, …)

IMG-CDC2BAD93093406D70B0F9A6F01B86BF

环境变量缺失无法将“open-webui”项识别为 cmdlet、函数、脚本文件或可运行程序的名称

如果报错:

open-webui serve
open-webui : 无法将“open-webui”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写,如果包括路径,请
确保路径正确,然后再试一次。
所在位置 行:1 字符: 1
+ open-webui serve
+ ~~~~~~~~~~
+ CategoryInfo : ObjectNotFound: (open-webui:String) [], CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException

这是因为没有将 python 对应的 Scripts 文件夹路径添加到环境变量中

  1. 如何查看路径在哪里
    在命令行中运行这一段
Terminal window
pip show requests
IMG-54444FCBA889BF74A543004B4163532D

能够看到这里面的 location, 所以实际的 script 的路径就是这个(site-packges 替换为 Scripts)

Terminal window
C:\Users\turbo\AppData\Roaming\Python\Python312\Scripts

把这个路径复制一下或者暂存到一个地方,我们需要把它保存在环境变量里面去(一般 windows 出现这个问题比较多,所以只写了对应的教程)

如何编辑环境变量

IMG-647D50202A16E26E1BE25AE4FC4E5DA1

搜索环境变量,进入编辑窗口

IMG-D9D3E5481059773AA8CCB5718E5EFB06

然后编辑系统变量把刚刚的那段路径添加到里面就可以了

IMG-3F25D1B9A693916B658415B17B64FDF4

然后再打开一个命令行运行

openwebui serve

就不会报找不到了

启动后长时间白屏的最终的解决方法

然后在 openwebui长时间白屏解决方案#现象描述 中有提到错误的原因在于当前环境无法连接到 openai。在使用 pip 安装的 packages 的时候,需要设置 ENABLE_OPENAI_API 的环境变量,具体做法如下:

  1. 在命令行中设置当前运行的环境变量 在 Linux/macOS 中:
    ENABLE_OPENAI_API=0 open-webui serve

在 Windows PowerShell 中:
$env:ENABLE_OPENAI_API=0; open-webui serve

在 Windows CMD 中:
set ENABLE_OPENAI_API=0 && open-webui serve


(题外话)如果你需要从. Env 读取环境变量那么,参考这个格式来写,
Using .env Files for Environment Variables in Python Applications - DEV Community

感谢阅读到这里,期待收到更多的反馈
欢迎关注公众号
kazoottt
公众号二维码