Modelpublic

jackuh02/CosyVoice2-Yue-mlx

sourceHugging Faceupdated 6mo agoView on Hugging Face

0likes23downloads

Model Card

jackuh02/CosyVoice2-Yue-mlx

This model was converted to MLX format from ASLP-lab/WSYue-TTS/CosyVoice2-Yue using mlx-audio-plus version 0.1.8.

Usage

bash

pip install -U mlx-audio-plus

Inference Modes

Mode	Parameters	Description
Cross-lingual	`ref_audio`	Zero-shot TTS (default)
Zero-shot	`ref_audio` + `ref_text`	Better quality with transcription
Instruct	`ref_audio` + `instruct_text`	Style control (e.g., "speak slowly")
Voice Conversion	`source_audio` + `ref_audio`	Convert audio to target voice

Command line

bash

# Cross-lingual (default)
mlx_audio.tts --model jackuh02/CosyVoice2-Yue-mlx --text "Hello!" --ref_audio ref.wav

# Zero-shot (with transcription)
mlx_audio.tts --model jackuh02/CosyVoice2-Yue-mlx --text "Hello!" --ref_audio ref.wav --ref_text "Transcription of ref audio."

# Instruct (style control)
mlx_audio.tts --model jackuh02/CosyVoice2-Yue-mlx --text "Hello!" --ref_audio ref.wav --instruct_text "Speak slowly and calmly"

# Voice Conversion
mlx_audio.tts --model jackuh02/CosyVoice2-Yue-mlx --source_audio source.wav --ref_audio ref.wav

Python

python

from mlx_audio.tts.generate import generate_audio

generate_audio(
    text="Hello, this is CosyVoice2 on MLX!",
    model="jackuh02/CosyVoice2-Yue-mlx",
    ref_audio="reference.wav",
    file_prefix="output",
)