Instructions to use MoYoYoTech/VoiceDialogue with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

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")
messages = [
    {"role": "user", "content": "Who are you?"},
]
pipe(messages)

# Load model directly
from transformers import AutoModel
model = AutoModel.from_pretrained("MoYoYoTech/VoiceDialogue", dtype="auto")

llama-cpp-python

How to use MoYoYoTech/VoiceDialogue with llama-cpp-python:

# !pip install llama-cpp-python

from llama_cpp import Llama

llm = Llama.from_pretrained(
	repo_id="MoYoYoTech/VoiceDialogue",
	filename="assets/models/llm/qwen/Qwen3-8B-Q6_K.gguf",
)

llm.create_chat_completion(
	messages = "\"The answer to the universe is 42\""
)

Notebooks
Google Colab
Kaggle
Local Apps Settings

llama.cpp

How to use MoYoYoTech/VoiceDialogue with llama.cpp:

Install from brew

brew install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama-server -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-server -hf MoYoYoTech/VoiceDialogue:Q6_K
# Run inference directly in the terminal:
llama-cli -hf MoYoYoTech/VoiceDialogue:Q6_K

Use pre-built binary

# Download pre-built binary from:
# https://github.com/ggerganov/llama.cpp/releases
# Start a local OpenAI-compatible server with a web UI:
./llama-server -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/ggerganov/llama.cpp.git
cd llama.cpp
cmake -B build
cmake --build build -j --target llama-server llama-cli
# Start a local OpenAI-compatible server with a web UI:
./build/bin/llama-server -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

LM Studio
Jan
Ollama
How to use MoYoYoTech/VoiceDialogue with Ollama:
```
ollama run hf.co/MoYoYoTech/VoiceDialogue:Q6_K
```

Unsloth Studio

How to use MoYoYoTech/VoiceDialogue with Unsloth Studio:

Install Unsloth Studio (macOS, Linux, WSL)

curl -fsSL https://unsloth.ai/install.sh | sh
# Run unsloth studio
unsloth studio -H 0.0.0.0 -p 8888
# Then open http://localhost:8888 in your browser
# Search for MoYoYoTech/VoiceDialogue to start chatting

Install Unsloth Studio (Windows)

irm https://unsloth.ai/install.ps1 | iex
# Run unsloth studio
unsloth studio -H 0.0.0.0 -p 8888
# Then open http://localhost:8888 in your browser
# Search for MoYoYoTech/VoiceDialogue to start chatting

Using HuggingFace Spaces for Unsloth

# No setup required
# Open https://huggingface.co/spaces/unsloth/studio in your browser
# Search for MoYoYoTech/VoiceDialogue to start chatting

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-server -hf MoYoYoTech/VoiceDialogue:Q6_K

Configure the model in Pi

# Install Pi:
npm install -g @mariozechner/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

Hermes Agent new

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-server -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 new
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

VoiceDialogue

Commit History

Bundle Qwen3-ASR weights in packaged app; slim PyInstaller assets

2e4bd5d

hzeng412 Claude Fable 5 commited on 10 days ago

ASR: use auto language detection to reject non-speech (fixes hallucination)

21dbad4

hzeng412 Claude Fable 5 commited on 10 days ago

Make Qwen3-ASR the default on main; bump to 1.2.0

3c70498

hzeng412 Claude Fable 5 commited on 11 days ago

Add audio output device (speaker) selection

a3bf559

hzeng412 Claude Fable 5 commited on 11 days ago

Show the active ASR engine in the UI

c3f5082

hzeng412 Claude Fable 5 commited on 11 days ago

Add script to convert TTS .bin weights to safetensors

e73f2e4

hzeng412 Claude Fable 5 commited on 12 days ago

Fix websocket route registration for starlette >= 1.0

a17b420

hzeng412 Claude Fable 5 commited on 12 days ago

ASR: add Qwen3-ASR engine, default zh/en to it on this branch

417ffa1

hzeng412 Claude Fable 5 commited on 12 days ago

README: lead with GUI (clone-and-run) quick start, move CLI after

3c3f610

hzeng412 Claude Opus 4.8 (1M context) commited on 12 days ago

Electron: open external links in system browser

89dd896

hzeng412 Claude Opus 4.8 (1M context) commited on 12 days ago

Add About tab in settings (models used + repo links)

45d25d1

hzeng412 Claude Opus 4.8 (1M context) commited on 12 days ago

Add external mic array support, UI i18n, glass settings redesign, and fixes

afd6c89

hzeng412 Claude Opus 4.8 (1M context) commited on 12 days ago

Update project docs.

2f3888a

liumaolin commited on Jul 24, 2025

refactor(core): Architecturally decouple Audio, ASR, and TTS modules

60f8238

liumaolin commited on Jul 24, 2025

简化LLM模型路径管理。

2baeba2

liumaolin commited on Jul 23, 2025

打包Python时默认激活Python虚拟环境

b319d19

liumaolin commited on Jul 18, 2025

修复electron app打包时，需要notary两次的问题

00c731a

liumaolin commited on Jul 18, 2025

[fix]: notarize debug info.

0d40789

Xin Zhang commited on Jul 18, 2025

更新前端资源文件

f7c398e

liumaolin commited on Jul 17, 2025

[fix]: role bugfix.

6883144

Xin Zhang commited on Jul 17, 2025

为LLMResponseGenerator类添加TaskStatusMixin混入，以增强任务有效性检查功能，确保在生成回答时任务状态的有效性。

d205383

liumaolin commited on Jul 16, 2025

Update frontend assets.

eeb7fe5

liumaolin commited on Jul 16, 2025

Merge branches 'main' and 'main' of hf.co:MoYoYoTech/VoiceDialogue

4029b29

Xin Zhang commited on Jul 15, 2025

[fix]: voice selection bugfix.

797cd52

Xin Zhang commited on Jul 15, 2025

更新音频任务处理逻辑，使用模型副本替代原始任务对象，以确保数据一致性和完整性。

2c7e742

liumaolin commited on Jul 15, 2025

重构处理LLM生成chunk内容的方法，以提高文本生成的准确性。

e3d17e2

liumaolin commited on Jul 15, 2025

去除对 LLM 输出的处理

08fc60d

liumaolin commited on Jul 15, 2025

更新LLM模型参数，调整top_p值为0.8，并添加max_tokens参数，设置为32768。

c531bfc

liumaolin commited on Jul 14, 2025

更新用户配置文件，修复logger导入路径以确保正确加载日志记录功能。

bbf79f2

liumaolin commited on Jul 14, 2025

更新加载页面图标路径，添加新的图标文件至assets/images目录。

fb2e3d6

liumaolin commited on Jul 11, 2025

更新前端文件

1cc5d82

liumaolin commited on Jul 11, 2025

[fix]: improve style.

31e11af

Xin Zhang commited on Jul 11, 2025

[fix]: remove frontend ref audio.

8ba9c84

Xin Zhang commited on Jul 11, 2025

Merge branch 'main' of hf.co:MoYoYoTech/VoiceDialogue

f71be4e

Xin Zhang commited on Jul 11, 2025

[feature]: update prompt config.

d35a0ba

Xin Zhang commited on Jul 11, 2025

添加获取TTS模型参考音频的API路由，支持通过模型ID获取音频文件。

226effc

liumaolin commited on Jul 11, 2025

Merge branch 'main' of hf.co:MoYoYoTech/VoiceDialogue

8ead306

Xin Zhang commited on Jul 11, 2025