Open WebUI 安装、卸载及使用指南

查看 Python 版本

在命令提示符中输入以下命令查看 Python 版本：

python --version

若当前 Python 版本不是 3.11，需切换至 3.11 版本。

安装 Open WebUI

确保 Python 版本为 3.11 后，在命令提示符中执行以下命令安装 Open WebUI：

pip install open-webui

安装完成后，可通过以下命令启动 Open WebUI：

open-webui serve

卸载 Open WebUI

完整示例步骤

1. 打开命令提示符：在 Windows 系统中，按下Win + R键，输入cmd并回车。
2. 卸载 open-webui：在命令提示符中输入以下命令：

pip uninstall open-webui

1. 确认卸载：系统会提示将要移除的文件路径，输入y并回车确认卸载。

Uninstalling open-webui-X.X.X:

  Would remove:

    c:\path\to\open-webui

  Proceed (Y/n)? y

Successfully uninstalled open-webui-X.X.X

1. 检查是否卸载成功：运行以下命令检查open-webui是否已被卸载：

pip list

若open-webui不再出现在列表中，说明卸载成功。

常见问题解决

如果 pip 命令不可用

确保已安装 Python 和 pip。可通过以下命令安装 pip（若尚未安装）：

python -m ensurepip --upgrade

或者，使用以下命令安装 pip：

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py

python get-pip.py

克隆及项目配置

克隆项目

在命令提示符中执行以下命令克隆 Open WebUI 项目：

git clone https://github.com/open-webui/open-webui.git

打开项目后配置前端（以 PyCharm 为例）

前端配置

1. 安装 nodejs：建议使用nvm下载并管理，推荐版本为 20.15.0（最好在 20 左右）。
2. 安装依赖：在项目根目录下（因为package.json在项目根目录下），执行以下命令安装依赖：

npm install

1. 构建：执行以下命令进行构建，构建成功后会出现build目录。若失败，删除node_modules后多试几次步骤 2 和 3。

npm build

后端（backend）配置

1. 安装 Python3.11：设置venv环境，终端打开后前面应显示(venv) PS 你的项目路径。
2. 安装依赖：在终端进入backend目录，执行以下命令安装依赖：

cd.\backend\

pip install -r.\requirements.txt

启动

在 Windows 系统中，在backend目录下执行以下命令启动（第一次打开需开启梯子，因为需要下载一些东西）：

.\start_windows.bat

注意事项

在每一个步骤中，若出现问题大概率是依赖版本的问题。可尝试降低相关依赖的版本，例如在部署过程中onnxruntime和torch版本可能出现问题，降低版本后即可解决。