ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

如何用 pip 安装 Open WebUI 并首次在 http://localhost:8080 打开界面

如何用 pip 安装 Open WebUI 并首次在 http://localhost:8080 打开界面 如何用 pip 安装 Open WebUI 并首次在 http://localhost:8080 打开界面【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui这篇文章解决一个具体任务在本机通过 pip 安装 Open WebUI启动服务并在浏览器里第一次打开http://localhost:8080的 Web 界面。完成后的结果是服务在本机 8080 端口运行浏览器中可以看到登录/注册界面第一个注册的账号会成为管理员。准备条件Python 版本安装前需要确认本机 Python 版本。README.md 在 pip 安装章节明确要求使用Python 3.11以避免兼容性问题Before proceeding, ensure youre usingPython 3.11to avoid compatibility issues.项目元数据给出的版本范围比这一句更宽pyproject.toml 中声明requires-python 3.11, 3.13.0a1。也就是说 3.11 和 3.12 都在声明的范围内但 README 给出的稳妥建议是 3.11本文按 README 的建议执行。可以用以下命令确认当前版本python --version如果不是 3.11先切换到 3.11 再执行后续步骤不建议直接沿用其他版本试装。安装 Open WebUI打开终端执行pip install open-webui这条命令会安装 Open WebUI 及其全部声明的依赖包括 FastAPI、uvicorn、向量库 ChromaDB 等完整依赖清单见 pyproject.toml。安装过程中不需要额外配置。启动服务安装完成后执行启动命令open-webui serve这个命令的行为在 CLI 入口 中可以看到默认监听host0.0.0.0、port8080所以 README 中给出的访问地址http://localhost:8080无需额外配置即可用如果没有设置环境变量WEBUI_SECRET_KEY首次运行会在当前工作目录生成一个.webui_secret_key文件默认 24 字节随机值编码之后每次启动都从该文件读取密钥。注意这个文件跟着当前目录走换目录启动会重新生成已注册用户可能无法登录因此建议固定在一个目录下运行。启动过程中 uvicorn 会加载应用首次启动需要执行数据库初始化等启动步骤等待终端不再滚动启动日志、服务进入就绪状态即可。验证打开 http://localhost:8080在浏览器中访问http://localhost:8080README 对启动结果的描述就是这一句This will start the Open WebUI server, which you can access at http://localhost:8080能看到登录/注册页面说明服务已正常启动。如果想不依赖浏览器验证服务是否活着可以请求健康检查端点这是项目容器入口脚本 backend/start.sh 中使用的检查方式curl -sf http://localhost:8080/health该端点定义见 backend/open_webui/main.py服务正常时返回{status: true}上面的输出为文档示例curl只要不报错-f下非 2xx 会退出即说明服务在监听。首次注册第一个账号即管理员打开http://localhost:8080后进入注册页面填写邮箱、密码和姓名完成注册。在全新实例上第一个注册的账号会被提升为管理员——这一点在 CHANGELOG.md 中有明确记录例如早期版本说明The setup process now explicitly informs users that they are creating an admin account during the first-time setup.也就是说首次打开界面时注册页面本身就会提示你正在创建管理员账号后续注册的其他账号则是普通用户。边界与限制本文只覆盖 pip 安装路径。README 同时提供 Docker、Docker Compose、Kustomize、Helm 等方式其中 Docker 默认对外端口是3000-p 3000:8080访问地址为http://localhost:3000与 pip 方式的 8080 不同不要混用两套地址。安装并打开界面后Open WebUI 本身不内置可对话的模型。要在聊天框里真正发消息还需要接入 Ollama 或 OpenAI 兼容 API在界面设置中配置 Ollama Server URL例如 TROUBLESHOOTING.md 中给出的http://localhost:11434示例。离线环境运行时按 README 的说明可设置HF_HUB_OFFLINE1避免启动时尝试从互联网下载模型export HF_HUB_OFFLINE1设置后再执行open-webui serve。遇到连接类问题主要是 Docker 部署下容器无法访问宿主机 OllamaREADME 的 Troubleshooting 章节建议加--networkhost参数并改用http://localhost:8080访问pip 方式不涉及该场景仅在此标明其适用范围。到此pip 安装、启动、打开界面、注册管理员账号这条路径就完成了服务运行在http://localhost:8080第一个账号已具备管理员权限下一步是去设置里配置模型服务端点。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表