Orpheus-TTS-Local

一个轻量级客户端，用于通过 LM Studio API 在本地运行 Orpheus TTS。

特性

• 🎧 使用 Orpheus TTS 模型实现高质量文本转语音
• 💻 完全本地运行，无需云 API 密钥
• 🔊 多种语音选项（tara、leah、jess、leo、dan、mia、zac、zoe）
• 💾 将音频保存为 WAV 文件

快速设置

1. 安装 LM Studio
2. 在 LM Studio 中下载 Orpheus TTS 模型 (orpheus-3b-0.1-ft-q4_k_m.gguf)
3. 在 LM Studio 中加载 Orpheus 模型
4. 在 LM Studio 中启动本地服务器（默认：http://127.0.0.1:1234）
5. 安装依赖：

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   

6. 运行脚本：

   python gguf_orpheus.py --text "Hello, this is a test" --voice tara
   

使用方法

python gguf_orpheus.py --text "您的文本在这里" --voice tara --output "output.wav"

选项

• --text: 要转换为语音的文本
• --voice: 要使用的语音（默认：tara）
• --output: 输出 WAV 文件路径（默认：自动生成文件名）
• --list-voices: 显示可用的语音
• --temperature: 生成温度（默认：0.6）
• --top_p: Top-p 采样参数（默认：0.9）
• --repetition_penalty: 重复惩罚（默认：1.1）

可用语音

• tara - 最适合通用场景的整体最佳语音（默认）
• leah
• jess
• leo
• dan
• mia
• zac
• zoe

情感

您可以通过添加以下标签来为语音添加情感：

<giggle>
<laugh>
<chuckle>
<sigh>
<cough>
<sniffle>
<groan>
<yawn>
<gasp>

许可证

Apache 2.0

Orpheus-TTS-Local 快速上手指南

Orpheus-TTS-Local 是一个轻量级客户端，允许你通过 LM Studio API 在本地运行高质量的 Orpheus TTS 模型，无需云端 API 密钥。

环境准备

• 操作系统：Windows / macOS / Linux
• 前置软件：
  • LM Studio（用于加载模型和启动本地服务）
  • Python 3.8+
• 模型文件：需下载 orpheus-3b-0.1-ft-q4_k_m.gguf 模型（可在 Hugging Face 获取，国内用户若访问受限可使用镜像站或代理加速）。

安装步骤

1. 配置 LM Studio

   • 安装并打开 LM Studio。
   • 搜索并下载模型：orpheus-3b-0.1-ft-q4_k_m.gguf。
   • 在 LM Studio 中加载该模型。
   • 点击左侧 "Local Server" 图标，启动本地服务器（默认地址：http://127.0.0.1:1234）。

2. 安装 Python 依赖 克隆或下载本项目代码后，在终端执行以下命令创建虚拟环境并安装依赖：

   python3 -m venv venv
   source venv/bin/activate  # Windows 用户使用: venv\Scripts\activate
   pip install -r requirements.txt
   

   提示：国内用户如遇 pip 下载缓慢，可添加清华源加速： pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

基本使用

最简单示例

将文本转换为语音并使用默认音色（tara）：

python gguf_orpheus.py --text "Hello, this is a test" --voice tara

常用参数说明

你可以自定义输出文件名、音色及生成参数：

python gguf_orpheus.py --text "Your text here" --voice leah --output "output.wav"

核心参数：

• --text: 需要转换的文本内容。
• --voice: 选择音色（可选：tara, leah, jess, leo, dan, mia, zac, zoe），默认为 tara。
• --output: 输出 WAV 文件的路径。
• --list-voices: 列出所有可用音色。

进阶技巧：添加情感

在文本中插入特定 XML 标签可模拟情感声音（如笑声、叹息等）：

python gguf_orpheus.py --text "<laugh> That was funny! <sigh> I guess so." --voice tara

支持的情感标签： <giggle>, <laugh>, <chuckle>, <sigh>, <cough>, <sniffle>, <groan>, <yawn>, <gasp>