oobabooga/text-generation-webui 源码下载_部署教程

项目概述

The definitive Web UI for local AI, with powerful features and easy setup.

项目地址

https://github.com/oobabooga/text-generation-webui

项目页面预览

oobabooga/text-generation-webui preview

关键指标

Stars：45849
主要语言：Python
License：GNU Affero General Public License v3.0
最近更新：2026-01-13T23:38:50Z
默认分支：main

本站高速下载（国内可用）

源码压缩包下载：点击下载（本站镜像）
SHA256：136e9ee053554d5abeae746fb42989ac3a3b06665a3b5efb7aac33a92f4c9106

安装部署要点（README 精选）

How to install

Option 2: Manual portable install with venv

Very fast setup that should work on any Python 3.9+:

# Clone repository
git clone https://github.com/oobabooga/text-generation-webui
cd text-generation-webui

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

# Install dependencies (choose appropriate file under requirements/portable for your hardware)
pip install -r requirements/portable/requirements.txt --upgrade

# Launch server (basic command)
python server.py --portable --api --auto-launch

# When done working, deactivate
deactivate

Option 3: One-click installer

For users who need additional backends (ExLlamaV3, Transformers) or extensions (TTS, voice input, translation, etc). Requires ~10GB disk space and downloads PyTorch.

Clone the repository, or download its source code and extract it.
Run the startup script for your OS: start_windows.bat, start_linux.sh, or start_macos.sh.
When prompted, select your GPU vendor.
After installation, open http://127.0.0.1:7860 in your browser.

To restart the web UI later, run the same start_ script.

You can pass command-line flags directly (e.g., ./start_linux.sh --help), or add them to user_data/CMD_FLAGS.txt (e.g., --api to enable the API).

To update, run the update script for your OS: update_wizard_windows.bat, update_wizard_linux.sh, or update_wizard_macos.sh.

To reinstall with a fresh Python environment, delete the installer_files folder and run the start_ script again.

One-click installer details

### One-click-installer

The script uses Miniforge to set up a Conda environment in the `installer_files` folder.

If you ever need to install something manually in the `installer_files` environment, you can launch an interactive shell using the cmd script: `cmd_linux.sh`, `cmd_windows.bat`, or `cmd_macos.sh`.

* There is no need to run any of those scripts (`start_`, `update_wizard_`, or `cmd_`) as admin/root.
* To install requirements for extensions, it is recommended to use the update wizard script with the “Install/update extensions requirements” option. At the end, this script will install the main requirements for the project to make sure that they take precedence in case of version conflicts.
* For automated installation, you can use the `GPU_CHOICE`, `LAUNCH_AFTER_INSTALL`, and `INSTALL_EXTENSIONS` environment variables. For instance: `GPU_CHOICE=A LAUNCH_AFTER_INSTALL=FALSE INSTALL_EXTENSIONS=TRUE ./start_linux.sh`.

Manual full installation with conda or docker

## 常用命令（从 README 提取）

# Clone repository
git clone https://github.com/oobabooga/text-generation-webui
cd text-generation-webui

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

# Install dependencies (choose appropriate file under requirements/portable for your hardware)
pip install -r requirements/portable/requirements.txt --upgrade

# Launch server (basic command)
python server.py --portable --api --auto-launch

# When done working, deactivate
deactivate

curl -sL "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh" > "Miniforge3.sh"
bash Miniforge3.sh

conda create -n textgen python=3.11
conda activate textgen

## 通用部署说明（适用于大多数项目）
1. 下载源码并阅读 README
2. 安装依赖（pip/npm/yarn 等）
3. 配置环境变量（API Key、模型路径、数据库等）
4. 启动服务并测试访问
5. 上线建议：Nginx 反代 + HTTPS + 进程守护（systemd / pm2）

## 免责声明与版权说明
本文仅做开源项目整理与教程索引，源码版权归原作者所有，请遵循对应 License 合规使用。

文章版权归作者所有，未经允许请勿转载。

THE END