OuteTTS

环境要求

• 已安装 Python 与 pip 的运行环境（README 未注明具体版本）
• 按硬件选择 llama.cpp 构建方式（llama.cpp Python bindings 默认随包安装，需按硬件指定）
• 如需 ExLlamaV2 或 VLLM 后端，需额外手动安装（README 标注 Requires manual installation）

安装与启动步骤

1. 1检查 Python 环境

   确认本机 Python 与 pip 可用。README 未给出具体版本要求，建议在虚拟环境中操作以隔离依赖。

   python --version

   复制

2. 2安装 OuteTTS 库

   使用 pip 安装 outetts。该库默认会带上 llama.cpp Python bindings，因此安装方式需结合你的硬件平台选择，必要时参考 llama.cpp 构建文档。

   pip install outetts

   复制

3. 3验证导入

   执行导入检查，确认包与默认后端已就绪，没有编译或 CUDA 相关报错。

   python -c "import outetts"

   复制

4. 4按需安装其他后端

   仅当使用 ExLlamaV2 或 VLLM 时才需要手动安装对应后端；默认后端无需额外操作。

5. 5设置采样参数

   使用 1.0 版本时必须按官方采样配置：温度 0.4、重复惩罚 1.1、重复范围 64、top-k 40、top-p 0.9、min-p 0.05。outetts 库已自动配置好各后端的采样器与补丁。

关键配置

如何确认成功

执行 python -c "import outetts" 无报错；再按 README 的基础用法示例跑一次合成，能得到可正常播放的语音输出。

常见问题

注意事项

• 重复惩罚必须限制在最近 64 token 窗口内，作用于整个上下文会导致输出损坏。
• README 的安装章节未给出完整 pip 命令，实际安装需结合硬件参考 llama.cpp 构建文档。
• 自定义实现时需自行保证采样器与重复惩罚补丁正确，outetts 库内已自动处理。
• 使用 1.0 版本时务必按官方采样表设置参数，不要随意改动。