audio-webui

环境要求

• Python 3.10（低于 3.10 不支持 "|" 类型注解，3.11 目前不支持 TTS 库）
• 已安装 Git（可在终端执行 git --version 验证）
• 部分功能需要安装 ffmpeg
• Windows 系统需要安装 Visual Studio C++ 生成工具

安装与启动步骤

1. 1检查 Git

   打开终端/命令行，输入命令确认 Git 是否可用；若提示找不到命令，请先到 git-scm.com 下载安装。

   git --version

   复制

2. 2确认 Python 版本

   本项目只在 Python 3.10 上可用，版本过低或 3.11 都可能报错，请先确认当前解释器版本。

   python --version

   复制

3. 3安装 ffmpeg

   部分音频功能依赖 ffmpeg，README 指向 ffmpeg.org，按系统方式安装并确保加入 PATH。

4. 4安装 C++ 生成工具

   仅 Windows 需要：安装 Visual Studio C++ build tools，否则部分依赖编译会失败。

5. 5获取项目代码

   README 的 Downloading 章节未在节选中给出，按官方仓库地址克隆到本地目录后进入项目文件夹。

   git clone https://github.com/gitmylo/audio-webui.git
   cd audio-webui

   复制

6. 6运行安装脚本

   Windows 双击或执行 run.bat，Linux/MacOS 执行 run.sh；脚本会自动在 venv 中安装全部依赖。

   run.bat

   复制

7. 7启动 WebUI

   安装完成后再次运行同一个脚本即可启动；Linux/MacOS 使用 run.sh，启动后按终端提示的地址访问。

   bash run.sh

   复制

如何确认成功

运行 run.bat 或 run.sh 后终端无报错、依赖自动装完并出现 Web 服务访问地址，浏览器打开该地址看到界面即成功。

常见问题

注意事项

• 运行脚本会自动创建 venv 并安装依赖，首次运行耗时较长，请保持网络畅通。
• Docker 相关仓库为社区维护，非官方支持。
• README 节选中未包含 Downloading 章节内容，克隆地址按官方仓库地址给出，如与文档不同以官方说明为准。
• 遇到问题可先查阅 Common issues 页面，再在项目仓库提交 issue。