summaryrefslogtreecommitdiff
path: root/README.md
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        # 独立命令行脚本
```