lollms-webui

环境要求

• Python 3.11（README 明确要求，可用 python --version 检查）
• Git，用于克隆仓库并拉取子模块
• Docker（可选，仅 Docker 运行方式需要）

安装与启动步骤

1. 1检查 Python 版本

   README 要求先确保安装 Python 3.11，用该命令查看当前版本；版本不符时到 python.org 下载 3.11.8。

   python --version

   复制

2. 2克隆仓库与子模块

   必须加 --recursive 拉取子模块；进入目录后再执行一次子模块更新，缺子模块会导致后续运行失败。

   git clone --recursive https://github.com/ParisNeo/lollms-webui.git
   cd lollms-webui
   git submodule update --init --recursive

   复制

3. 3创建虚拟环境

   在项目根目录创建虚拟环境，隔离依赖、避免污染系统 Python 包，README 推荐使用。

   python -m venv venv

   复制

4. 4激活虚拟环境

   Linux/Mac 用 source venv/bin/activate；Windows 用 venvScriptsctivate，激活后再进行后续安装。

   source venv/bin/activate

   复制

5. 5运行自动安装脚本

   从仓库 scripts 文件夹下载并运行对应脚本：Windows 为 lollms_installer.bat，Linux 为 lollms_installer.sh，Mac 为 lollms_installer_macos.sh。

   bash lollms_installer.sh

   复制

6. 6构建 Docker 镜像

   使用 Docker 方式时，需先进入 lollms-webui 目录再执行构建，镜像名为 lollms-webui-app。

   docker build -t lollms-webui-app .

   复制

7. 7运行 Docker 容器

   后台启动容器并把容器 9600 端口映射到宿主机 9600，容器名固定为 lollms-webui-container。

   docker run -d -p 9600:9600 --name lollms-webui-container lollms-webui-app

   复制

关键配置

如何确认成功

启动后在浏览器打开 http://localhost:9600 ，能看到 lollms-webui 的 Web 界面即启动成功。

常见问题

注意事项

• README 说明 lollms-webui 仅维持最小支持，最终会被新的 lollms 项目（支持多用户与 MCP）完全取代，新项目建议关注 https://github.com/ParisNeo/lollms 。
• 手动安装流程在 README 节选中未给出完整的依赖安装命令，本教程只保留了 README 已明确写出的步骤。
• 自动安装脚本需要先从仓库 scripts 文件夹获取对应平台脚本文件再运行。