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")

# 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

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"

VoiceDialogue

Commit History

Jun 13, 2025

03:44
Update static file routing and root endpoint for frontend integration⁠

liumaolin

f7b034a
03:29
Update Python subprocess termination to use SIGKILL instead of SIGTERM for forceful termination

liumaolin

86dbbe1
03:11
Replace `ffmpeg`-based audio loading with `soundfile` and `librosa`⁠

liumaolin

b6d76bc

Jun 12, 2025

15:23
[fix]: update web.

Xin Zhang

5f9e92a
10:08
Update README.

liumaolin

2c7b9b6
08:17
Add robust lifecycle management for `audio_player` service in system routes⁠

liumaolin

627c3e7
07:47
Standardize service lifecycle management by replacing `stop` with `exit` and introducing `is_exited` check⁠

liumaolin

f5226c0
07:42
Remove `voice_schemas.py` and refactor schema imports for TTS and ASR modules in `__init__.py`

liumaolin

4895dc2
07:29
Refactor speech recognizer, audio capture, and system routes for improved clarity and functionality⁠

liumaolin

037e5ae
03:51
Update `.gitignore` to exclude `electron-app/dist` directory

liumaolin

8366d25
03:49
Add macOS entitlements and assets for Electron app build⁠

liumaolin

95e7f8b
03:48
Add Electron app scaffolding with loading screen and Python backend integration

liumaolin

065b0f6
03:47
Add build scripts for project packaging and cleanup⁠

liumaolin

c723658
03:44
Update app title in index.html to "Voice Dialogue"

liumaolin

a09c130
03:44
Add pause and resume functionality to voice dialogue system⁠

liumaolin

d701b8a
02:18
Remove deprecated `whisper/ggml-large-v3-turbo-encoder` model files and metadata

liumaolin

fdf6e7b
02:04
Add PyInstaller and related dependencies to `dev` dependency group

liumaolin

f8c6d08
02:04
Update README: clarify instructions, update paths, and refine directory structure documentation

liumaolin

de86e54
02:03
Refactor `main.py`: remove redundant code, modularize functionality, and set multiprocessing to `spawn` for PyInstaller compatibility.

liumaolin

84faf7d
01:41
Refactor project: split `main.py` functionality into modular components under `cli`, `core`, and `config`.

liumaolin

d08a15b
01:38
Increase service startup timeouts and set daemon mode for services.

liumaolin

61524a8

Jun 11, 2025

09:38
Add `build-python.sh`: script for packaging Python application with PyInstaller.

liumaolin

3764026
09:17
Update `.gitignore`: add `electron-app/python-dist` to ignore list

liumaolin

1147458
09:16
Remove unused assets: delete `appicon.png` and `dmg_bg.png` from `electron-app`.

liumaolin

28a4171
09:15
Update `voice_dialogue.spec`: add comments for build stages and disable macOS `.app` bundle configuration

liumaolin

9cf375f
07:50
Organize assets: rename icons to `electron-app/assets/icons` and add `dmg_bg.png` to `electron-app/assets/images`.

liumaolin

de71b66
07:43
Add `appicon.png` to project build icons

liumaolin

5b7a01e
07:40
Add `moyoyo.icns` icon file to project

liumaolin

c3cccd9
07:39
Update `.gitattributes`: add LFS support for `.icns` files

liumaolin

8d92991
07:38
Add PyInstaller hooks and spec file for project packaging.

liumaolin

aa586b2
07:33
Refactor imports in `whisper.py` and `funasr.py` to use absolute paths for `ensure_minimum_audio_duration`.

liumaolin

d673573
02:55
Update `moyoyo.py`: add fallback for `utils` to ensure `HParams` availability in runtime.

liumaolin

bd3673b
02:54
Update `main.py`: modify `uvicorn.run` to use updated `voice_dialogue.api.app` module path.

liumaolin

15e98c9
02:54
Trim `requirements.txt` to remove autogenerated content and unused dependencies.

liumaolin

f782fe5
02:11
Enhance `main.py`: add `multiprocessing.freeze_support()` for compatibility and improve `lib_path` existence check before modifying sys.path.

liumaolin

824183a
02:11
Refactor import statement in `lr_schedulers.py`: move `matplotlib` import to main guard to reduce unnecessary module loading.

liumaolin

26079e1
02:11
Refactor imports for consistency in `kokoro.py` and `processor.py`. Use absolute paths for better readability and maintainability.

liumaolin

8630353
02:09
Update `paths.py`: improve PROJECT_ROOT resolution with `_MEIPASS` support and enhance third-party path handling.

liumaolin

664d767

Jun 10, 2025

08:57
Rename 'src/VoiceDialogue' to 'src/voice_dialogue'.

liumaolin

511ff0c
07:48
Update `.gitignore` to exclude `electron-app/node_modules` directory.

liumaolin

6eec50d

Jun 11, 2025

02:50
[feature]: update www.

Xin Zhang

9906289

Jun 9, 2025

10:31
Revamp API core description: expand feature details for ASR, LLMs, TTS, system control, and real-time communication; improve clarity and structure of documentation.

liumaolin

c57de2a
10:28
Update README file.

liumaolin

a5d5551
10:18
Add `pyproject.toml` and `uv.lock` files to define project metadata and dependencies.

liumaolin

3cbe74d
10:18
Update README file.

liumaolin

be3d38f
10:03
Update project requirements.

liumaolin

ccdd95f
10:00
Update project requirements.

liumaolin

5c8fde8
10:00
Integrate WebSocket support: add `/api/v1/ws` endpoint, enable real-time message handling via `websocket_message_queue`, and refactor services and models to support WebSocket-based question and answer updates.

liumaolin

2534744
07:28
Refactor `SessionIdManager` module: rename `session_id_manager.py` to `session_manager.py` and update imports accordingly.

liumaolin

83ef092
07:27
Refactor session ID handling: replace `current_session_id` with `SessionIdManager` for thread-safe management, update related imports and references.

liumaolin

92bb56d

Commit History

Jun 13, 2025

Update static file routing and root endpoint for frontend integration⁠

Update Python subprocess termination to use SIGKILL instead of SIGTERM for forceful termination

Replace `ffmpeg`-based audio loading with `soundfile` and `librosa`⁠

Jun 12, 2025

[fix]: update web.

Update README.

Add robust lifecycle management for `audio_player` service in system routes⁠

Standardize service lifecycle management by replacing `stop` with `exit` and introducing `is_exited` check⁠

Remove `voice_schemas.py` and refactor schema imports for TTS and ASR modules in `__init__.py`

Refactor speech recognizer, audio capture, and system routes for improved clarity and functionality⁠

Update `.gitignore` to exclude `electron-app/dist` directory

Add macOS entitlements and assets for Electron app build⁠

Add Electron app scaffolding with loading screen and Python backend integration

Add build scripts for project packaging and cleanup⁠

Update app title in index.html to "Voice Dialogue"

Add pause and resume functionality to voice dialogue system⁠

Remove deprecated `whisper/ggml-large-v3-turbo-encoder` model files and metadata

Add PyInstaller and related dependencies to `dev` dependency group

Update README: clarify instructions, update paths, and refine directory structure documentation

Refactor `main.py`: remove redundant code, modularize functionality, and set multiprocessing to `spawn` for PyInstaller compatibility.

Refactor project: split `main.py` functionality into modular components under `cli`, `core`, and `config`.

Increase service startup timeouts and set daemon mode for services.

Jun 11, 2025

Add `build-python.sh`: script for packaging Python application with PyInstaller.

Update `.gitignore`: add `electron-app/python-dist` to ignore list

Remove unused assets: delete `appicon.png` and `dmg_bg.png` from `electron-app`.

Update `voice_dialogue.spec`: add comments for build stages and disable macOS `.app` bundle configuration

Organize assets: rename icons to `electron-app/assets/icons` and add `dmg_bg.png` to `electron-app/assets/images`.

Add `appicon.png` to project build icons

Add `moyoyo.icns` icon file to project

Update `.gitattributes`: add LFS support for `.icns` files

Add PyInstaller hooks and spec file for project packaging.

Refactor imports in `whisper.py` and `funasr.py` to use absolute paths for `ensure_minimum_audio_duration`.

Update `moyoyo.py`: add fallback for `utils` to ensure `HParams` availability in runtime.

Update `main.py`: modify `uvicorn.run` to use updated `voice_dialogue.api.app` module path.

Trim `requirements.txt` to remove autogenerated content and unused dependencies.

Enhance `main.py`: add `multiprocessing.freeze_support()` for compatibility and improve `lib_path` existence check before modifying sys.path.

Refactor import statement in `lr_schedulers.py`: move `matplotlib` import to main guard to reduce unnecessary module loading.

Refactor imports for consistency in `kokoro.py` and `processor.py`. Use absolute paths for better readability and maintainability.

Update `paths.py`: improve PROJECT_ROOT resolution with `_MEIPASS` support and enhance third-party path handling.

Jun 10, 2025

Rename 'src/VoiceDialogue' to 'src/voice_dialogue'.

Update `.gitignore` to exclude `electron-app/node_modules` directory.

Jun 11, 2025

[feature]: update www.

Jun 9, 2025

Revamp API core description: expand feature details for ASR, LLMs, TTS, system control, and real-time communication; improve clarity and structure of documentation.

Update README file.

Add `pyproject.toml` and `uv.lock` files to define project metadata and dependencies.

Update README file.

Update project requirements.

Update project requirements.

Integrate WebSocket support: add `/api/v1/ws` endpoint, enable real-time message handling via `websocket_message_queue`, and refactor services and models to support WebSocket-based question and answer updates.

Refactor `SessionIdManager` module: rename `session_id_manager.py` to `session_manager.py` and update imports accordingly.

Refactor session ID handling: replace `current_session_id` with `SessionIdManager` for thread-safe management, update related imports and references.

Remove `voice_schemas.py` and refactor schema imports for TTS and ASR modules in `init.py`