Orpheus-TTS

环境要求

• Python 环境（README 使用 Python 包 orpheus_tts 调用模型）
• 可访问 Google Colab 或 Baseten 的浏览器环境（README 提供云端使用方式）
• 如需本地使用仓库修复版代码，需在本地克隆 Orpheus-TTS 仓库
• Baseten 账号（用于一键部署生产级实时流式推理）

安装与启动步骤

1. 1用 Colab 试用微调模型

   README 提供 Colab For Tuned Model 笔记本，适合日常 TTS 应用，但非流式，实时流式请参考其他方式。

2. 2用 Colab 试用预训练模型

   README 提供的预训练模型 Colab 笔记本，默认为条件生成设置，可扩展到其他任务。

3. 3克隆仓库到本地

   如需使用仓库内代码（本地包）而非已安装的 PyPI 版本，先克隆仓库并进入目录。

   git clone https://github.com/canopyai/Orpheus-TTS.git
   cd Orpheus-TTS

   复制

4. 4改用仓库本地包

   若克隆仓库后遇到 KV cache 报错或 max_model_len 属性不存在的报错，按 README 改为导入仓库内的本地包。

   import sys
   sys.path.insert(0, 'orpheus_tts_pypi')
   from orpheus_tts import OrpheusModel

   复制

5. 5Baseten 一键部署

   README 推荐 Baseten 作为首选推理合作方，可在其平台一键获得带实时流式的专用部署。

如何确认成功

Colab 笔记本运行后能成功生成并播放语音；Baseten 部署后实例处于运行状态并能实时流式输出。

常见问题

注意事项

• README 未给出本地 pip 安装命令，所有依赖安装步骤请以官方仓库与笔记本为准，不要凭空安装包名。
• 多语言模型为研究预览版本，README 明确说明其定位为 research preview。
• Baseten 是官方首选推理合作方，提供 fp8 与 fp16 两种推理精度选项。
• README 中的 Colab 微调模型笔记本不支持流式，需要实时流式请选择其他方式。