【亲测免费】 LoLLMS WebUI 安装与使用教程

1. 项目目录结构及介绍

在 https://github.com/ParisNeo/lollms-webui.git 的源码中，主要的目录结构如下：

.
├── README.md       // 项目说明文件
├── app.py          // 主应用文件
├── docker-compose.yml  // Docker 集成部署配置
├── installer.sh     // 安装脚本
├── installer_cpu.sh  // CPU版本安装脚本
├── lollms_webui.py   // 网络接口实现文件
├── models.yaml      // 模型配置文件
├── package-lock.json // npm包依赖锁定文件（如果是前端组件）
├── package.json     // npm 包配置文件（如果是前端组件）
├── requirements.txt  // Python依赖项列表
└── requirements_dev.txt // 开发环境额外依赖项

• README.md: 项目的基本信息、安装和使用指南。
• app.py, lollms_webui.py: 该项目的核心Python代码，用于处理HTTP请求和服务端逻辑。
• docker-compose.yml: 使用Docker进行集成部署的配置文件。
• installer.sh, installer_cpu.sh: 提供简单的命令行安装流程。
• models.yaml: 配置不同模型参数的地方。
• requirements*.txt: Python依赖库清单。

2. 项目启动文件介绍

项目提供两个启动文件，分别是 bash webui.sh 和 ./app.py 或 python3 app.py。

• webui.sh: 这是一个shell脚本，用于下载并安装项目所需的所有依赖。执行此脚本来启动WebUI，并且可以用于后期重新启动应用程序。

  bash webui.sh
  

• app.py: 直接运行这个Python文件也可以启动应用，适用于手动调试或不依赖安装脚本的情况。

  python3 app.py
  

确保你的系统已经安装了所需的依赖（如Python3，git等），并且有权限执行上述命令。

3. 项目的配置文件介绍

LoLLMS WebUI 的主要配置文件是 models.yaml，它定义了对接大型语言模型的相关设置，包括模型名称、API端点以及任何特定于模型的参数。例如：

models:
  - name: model1
    api_url: "http://localhost:5000"
    prompt_format: "User: {user_input}\nModel:"
    max_tokens: 2048
    temperature: 0.7
    top_p: 0.9
    repetition_penalty: 1.2

在这个例子中，

• name: 模型的内部标识名。
• api_url: 对应模型服务的URL。
• prompt_format: 模型输入的提示格式。
• max_tokens: 单个回复的最大令牌数。
• temperature: 影响生成结果多样性的参数。
• top_p: 采样时保留的概率总和阈值。
• repetition_penalty: 抑制重复单词的惩罚系数。

修改这些参数可以调整模型的行为以满足不同的应用场景需求。

为了保障安全性，项目还可能涉及其他配置，如允许远程访问、设置服务器模式等，具体可在相关代码或配置文件中查找并调整。但请注意，LoLLMS WebUI 并未内置用户认证功能，因此在开启远程访问前，务必遵循安全最佳实践，并考虑实施额外的安全措施。