Text-to-Speech
Transformers
ONNX
GGUF
Chinese
English
voice-dialogue
speech-recognition
large-language-model
asr
tts
llm
chinese
english
real-time
conversational
Instructions to use MoYoYoTech/VoiceDialogue with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use MoYoYoTech/VoiceDialogue with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-to-speech", model="MoYoYoTech/VoiceDialogue")# pip install -U transformers accelerate # Load model directly from transformers import AutoModel model = AutoModel.from_pretrained("MoYoYoTech/VoiceDialogue", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use MoYoYoTech/VoiceDialogue with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf MoYoYoTech/VoiceDialogue:Q6_K # Run inference directly in the terminal: llama cli -hf MoYoYoTech/VoiceDialogue:Q6_K
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf MoYoYoTech/VoiceDialogue:Q6_K # Run inference directly in the terminal: llama cli -hf MoYoYoTech/VoiceDialogue:Q6_K
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf MoYoYoTech/VoiceDialogue:Q6_K # Run inference directly in the terminal: ./build/bin/llama cli -hf MoYoYoTech/VoiceDialogue:Q6_K
Use Docker
docker model run hf.co/MoYoYoTech/VoiceDialogue:Q6_K
- Llama new
- LM Studio
- Jan
- Ollama
How to use MoYoYoTech/VoiceDialogue with Ollama:
ollama run hf.co/MoYoYoTech/VoiceDialogue:Q6_K
- Unsloth Desktop
- Pi
How to use MoYoYoTech/VoiceDialogue with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf MoYoYoTech/VoiceDialogue:Q6_K
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "MoYoYoTech/VoiceDialogue:Q6_K" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use MoYoYoTech/VoiceDialogue with Docker Model Runner:
docker model run hf.co/MoYoYoTech/VoiceDialogue:Q6_K
- Lemonade
How to use MoYoYoTech/VoiceDialogue with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull MoYoYoTech/VoiceDialogue:Q6_K
Run and chat with the model
lemonade run user.VoiceDialogue-Q6_K
List all available models
lemonade list
- Hermes Agent
How to use MoYoYoTech/VoiceDialogue with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf MoYoYoTech/VoiceDialogue:Q6_K
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default MoYoYoTech/VoiceDialogue:Q6_K
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use MoYoYoTech/VoiceDialogue with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf MoYoYoTech/VoiceDialogue:Q6_K
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "MoYoYoTech/VoiceDialogue:Q6_K" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
liumaolin commited on
Commit ·
be3d38f
1
Parent(s): ccdd95f
Update README file.
Browse files
README.md
CHANGED
|
@@ -109,8 +109,13 @@ cd VoiceDialogue
|
|
| 109 |
|
| 110 |
2. **创建并激活虚拟环境**
|
| 111 |
```bash
|
| 112 |
-
# 使用
|
| 113 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 114 |
conda activate voicedialogue
|
| 115 |
|
| 116 |
# 或使用 venv
|
|
@@ -118,27 +123,28 @@ python -m venv voicedialogue
|
|
| 118 |
source voicedialogue/bin/activate
|
| 119 |
```
|
| 120 |
|
| 121 |
-
3. **安装
|
| 122 |
```bash
|
| 123 |
-
#
|
| 124 |
-
WHISPER_COREML=1
|
| 125 |
|
| 126 |
-
#
|
| 127 |
-
CMAKE_ARGS="-DGGML_METAL=on" pip install
|
| 128 |
```
|
| 129 |
|
| 130 |
-
4. **安装
|
| 131 |
```bash
|
| 132 |
-
|
|
|
|
| 133 |
```
|
| 134 |
|
| 135 |
-
5. **安装
|
| 136 |
```bash
|
| 137 |
-
#
|
| 138 |
-
|
| 139 |
|
| 140 |
-
#
|
| 141 |
-
|
| 142 |
```
|
| 143 |
|
| 144 |
### 🎮 运行系统
|
|
@@ -151,18 +157,22 @@ sudo apt update && sudo apt install ffmpeg
|
|
| 151 |
|
| 152 |
```bash
|
| 153 |
# 启动语音对话系统 (默认使用中文,沈逸角色)
|
|
|
|
|
|
|
| 154 |
python src/VoiceDialogue/main.py
|
| 155 |
|
| 156 |
# 指定语言和角色
|
|
|
|
|
|
|
| 157 |
python src/VoiceDialogue/main.py --language en --speaker Heart
|
| 158 |
|
| 159 |
# 查看所有可用角色
|
|
|
|
|
|
|
| 160 |
python src/VoiceDialogue/main.py --help
|
| 161 |
```
|
| 162 |
|
| 163 |
**首次运行说明**:
|
| 164 |
-
- 系统会自动下载所需的模型文件 (约 10-15GB),请耐心等待。
|
| 165 |
-
- 模型文件会保存在 `~/.moyoyo_ai/` 目录下。
|
| 166 |
- 看到 "服务启动成功" 提示后即可开始说话。
|
| 167 |
|
| 168 |
#### 2. API 服务模式
|
|
|
|
| 109 |
|
| 110 |
2. **创建并激活虚拟环境**
|
| 111 |
```bash
|
| 112 |
+
# 使用 uv (推荐)
|
| 113 |
+
pip install uv
|
| 114 |
+
uv venv
|
| 115 |
+
source .venv/bin/activate
|
| 116 |
+
|
| 117 |
+
# 或使用 conda
|
| 118 |
+
conda create -n voicedialogue python=3.11
|
| 119 |
conda activate voicedialogue
|
| 120 |
|
| 121 |
# 或使用 venv
|
|
|
|
| 123 |
source voicedialogue/bin/activate
|
| 124 |
```
|
| 125 |
|
| 126 |
+
3. **安装项目依赖**
|
| 127 |
```bash
|
| 128 |
+
# 使用 uv (推荐)
|
| 129 |
+
WHISPER_COREML=1 CMAKE_ARGS="-DGGML_METAL=on" uv sync
|
| 130 |
|
| 131 |
+
# 或使用 pip
|
| 132 |
+
WHISPER_COREML=1 CMAKE_ARGS="-DGGML_METAL=on" pip install -r requirements.txt
|
| 133 |
```
|
| 134 |
|
| 135 |
+
4. **安装音频处理工具**
|
| 136 |
```bash
|
| 137 |
+
# macOS
|
| 138 |
+
brew install ffmpeg
|
| 139 |
```
|
| 140 |
|
| 141 |
+
5. **手动安装额外依赖**
|
| 142 |
```bash
|
| 143 |
+
# 安装 kokoro-onnx 和指定版本的 numpy
|
| 144 |
+
pip install kokoro-onnx
|
| 145 |
|
| 146 |
+
# 重新安装指定版本的 numpy
|
| 147 |
+
pip install numpy==1.26.4
|
| 148 |
```
|
| 149 |
|
| 150 |
### 🎮 运行系统
|
|
|
|
| 157 |
|
| 158 |
```bash
|
| 159 |
# 启动语音对话系统 (默认使用中文,沈逸角色)
|
| 160 |
+
uv run src/VoiceDialogue/main.py
|
| 161 |
+
# 或
|
| 162 |
python src/VoiceDialogue/main.py
|
| 163 |
|
| 164 |
# 指定语言和角色
|
| 165 |
+
uv run src/VoiceDialogue/main.py --language en --speaker Heart
|
| 166 |
+
# 或
|
| 167 |
python src/VoiceDialogue/main.py --language en --speaker Heart
|
| 168 |
|
| 169 |
# 查看所有可用角色
|
| 170 |
+
uv run src/VoiceDialogue/main.py --help
|
| 171 |
+
# 或
|
| 172 |
python src/VoiceDialogue/main.py --help
|
| 173 |
```
|
| 174 |
|
| 175 |
**首次运行说明**:
|
|
|
|
|
|
|
| 176 |
- 看到 "服务启动成功" 提示后即可开始说话。
|
| 177 |
|
| 178 |
#### 2. API 服务模式
|