摘要：open-webui是一个流行的开源项目，用于构建基于大型语言模型（LLMs）的用户界面。以下是在 Windows 和 macOS 上安装 open-webui 的详细步骤，并配有相应的图片说明。
open-webui是一个流行的开源项目，用于构建基于大型语言模型（LLMs）的用户界面。以下是在 Windows 和 macOS 上安装 open-webui 的详细步骤，并配有相应的图片说明。
前提条件：
您的计算机上已经安装了 Node.js 和 npm (Node Package Manager)。Windows: 访问 https://nodejs.org/ 下载并安装最新的 LTS (长期支持) 版本。安装过程中请确保勾选 "Add to PATH" 选项。macOS: 推荐使用 Homebrew 安装。如果未安装 Homebrew，请访问 https://brew.sh/ 按照说明进行安装。安装完成后，在终端中运行 brew install node。您需要一个 LLM API 的接入方式，例如 OpenAI API key、Anthropic API key，或者您本地运行的 Ollama、LM Studio 等服务的地址。步骤 1：克隆 open-webui 仓库
打开您的终端 (macOS) 或命令提示符 (Windows)，选择一个您想要存放 open-webui 项目的目录，并执行以下命令来克隆 GitHub 仓库：
git clone https://github.com/open-webui/open-webui.git
cd open-webui
图片 1：克隆 open-webui 仓库
您会在终端或命令提示符中看到 Git 克隆项目的过程。
步骤 2：安装依赖
在克隆下来的 open-webui 目录下，运行以下命令来安装项目所需的依赖：
npm install
图片 2：安装依赖
终端或命令提示符会显示 npm 下载和安装依赖包的过程，这可能需要一些时间。
步骤 3：配置环境变量
复制项目根目录下的 .env.example 文件，并将其重命名为 .env。
Windows: 在文件资源管理器中复制粘贴并重命名。
macOS: 在终端中运行以下命令：
cp .env.example .env
图片 3：复制 .env.example 文件
文件管理器 (Windows) 或终端 (macOS) 中显示复制 .env.example 并重命名为 .env 的操作。
使用文本编辑器 (例如记事本、Visual Studio Code、TextEdit) 打开 .env 文件，并根据您的需求配置以下环境变量（至少需要配置一个 LLM API）：
DEFAULT_MODEL: 设置默认使用的模型名称。OPENAI_API_KEY: 如果您使用 OpenAI API，在此处填写您的 API 密钥。ANTHROPIC_API_KEY: 如果您使用 Anthropic API，在此处填写您的 API 密钥。OLLAMA_BASE_URL: 如果您使用本地 Ollama 服务，在此处填写服务的 URL (例如 http://localhost:11434).LM_STUDIO_BASE_URL: 如果您使用本地 LM Studio 服务，在此处填写服务的 URL (例如 http://localhost:8080).注意： 您只需要配置您打算使用的 LLM API 相关的环境变量。
图片 4：编辑 .env 文件
文本编辑器中打开的 .env 文件，显示了可以配置的 API 密钥和其他选项。
步骤 4：启动 open-webui
在 open-webui 目录下，运行以下命令来启动应用程序：
npm run dev
图片 5：启动 open-webui
终端或命令提示符会显示 open-webui 启动的日志信息，通常会指示服务运行在哪个端口。
步骤 5：访问 open-webui 界面
在您的 Web 浏览器中访问通常在终端输出中指示的地址。默认情况下，它通常是 http://localhost:3000。
图片 6：open-webui 界面 (预期)
您应该能够看到 open-webui 的用户界面，可以开始配置您的 LLM 连接并进行对话。
常见问题和故障排除：
依赖安装失败： 确保您的 Node.js 和 npm 版本符合项目要求。尝试删除 node_modules 文件夹和 package-lock.json 文件，然后重新运行 npm install。环境变量未生效： 确保您已经将 .env.example 复制并重命名为 .env，并且在启动服务之前正确配置了其中的环境变量。重启服务后查看是否生效。端口冲突： 如果 3000 端口被占用，您可以在 .env 文件中修改 PORT 环境变量来更改 open-webui 的运行端口。API 连接问题： 检查您配置的 API 密钥或服务地址是否正确。停止 open-webui 服务：
在运行 open-webui 的终端或命令提示符中，按下 Ctrl + C 停止服务。
希望这些详细步骤和图片能够帮助您成功在 Windows 和 macOS 上安装并运行 open-webui！如果您在安装过程中遇到任何问题，请随时提问。
来源：生活小创意DIY
