blob: 6cdc38bfb2d56b86177f1395eeec7a62c51e6899 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
# MiMo V2.5 TTS — Hermes Agent Plugin
Xiaomi MiMo V2.5 语音合成插件,为 Hermes Agent 提供高质量中英文 TTS 能力。
## 功能
- 9 个内置音色(4 中文 + 4 英文 + 1 自动)
- 3 种模型:内置音色 / 语音设计 / 声音克隆
- 自然语言风格控制(播音员、讲故事、方言、情绪等)
- 流式输出支持
- 兼容 Hermes 语音气泡投递(Telegram 等)
## 音色列表
| ID | 名称 | 语言 | 性别 |
|----|------|------|------|
| `mimo_default` | 默认 | 自动 | - |
| `冰糖` | Bingtang | 中文 | 女 |
| `茉莉` | Moli | 中文 | 女 |
| `苏打` | Suda | 中文 | 男 |
| `白桦` | Baihua | 中文 | 男 |
| `Mia` | Mia | 英文 | 女 |
| `Chloe` | Chloe | 英文 | 女 |
| `Milo` | Milo | 英文 | 男 |
| `Dean` | Dean | 英文 | 男 |
## 使用示例
### Hermes 内置调用
配置完成后,Hermes 的 `text_to_speech` 工具会自动走 MiMo:
```
text_to_speech(text="你好世界")
```
### 独立命令行
```bash
# 基本用法
python3 ~/mimo_tts.py "你好世界" --voice 冰糖
# 指定输出路径
python3 ~/mimo_tts.py "测试" --voice 茉莉 -o output.wav
# 列出音色 / 模型
python3 ~/mimo_tts.py --list-voices
python3 ~/mimo_tts.py --list-models
```
### Python API
```python
import sys, os
sys.path.insert(0, os.path.expanduser("~/.hermes/hermes-agent"))
os.environ.setdefault("XIAOMI_API_KEY", "your_key")
import importlib.util
spec = importlib.util.spec_from_file_location(
"mimo_tts", os.path.expanduser("~/.hermes/plugins/tts/mimo/__init__.py")
)
mod = importlib.util.module_from_spec(spec)
spec.loader.exec_module(mod)
provider = mod.MiMoTTSProvider()
provider.synthesize("你好世界", "output.wav", voice="冰糖")
```
## 文件说明
```
mimo-tts-for-hermes/
├── README.md # 本文档(介绍)
├── INSTALL.md # 安装说明(给 Agent 看)
├── plugin.yaml # Hermes 插件清单
├── setup.sh # 安装/卸载脚本(仅供参考)
├── __init__.py # 插件注册入口 + TTSProvider 实现
└── mimo_tts.py # 独立命令行脚本
```
|