qwen-tts

Generate speech from text using the Qwen3-TTS model on Mac MLX hardware.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/kazuph/dotfiles --skill qwen-tts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qwen-tts
Source: https://github.com/kazuph/dotfiles/tree/main/plugins/kazuph-dotfiles/skills/qwen-tts
Command: npx skills add https://github.com/kazuph/dotfiles --skill qwen-tts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mlx-audio, soundfile, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a streamlined way to generate speech from text using the Qwen3-TTS model, optimized for efficiency and quality on Mac MLX hardware.

Core Features & Use Cases

  • Text-to-Speech Generation: Convert written text into natural-sounding speech with customizable voice characteristics.
  • Parameter Tuning: Optimize generation speed (RTF) and voice quality using parameters like max_tokens, temperature, and repetition_penalty.
  • Use Case: Create voiceovers for videos, generate audio for accessibility features, or develop interactive voice response systems.

Quick Start

Use the qwen-tts skill to generate an audio file named 'greeting.wav' from the text 'Hello, world!' with a cheerful female voice.

Frequently Asked Questions about qwen-tts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate speech from text on Mac MLX hardware?▼

You can generate speech from text on Mac MLX hardware by using the Qwen3-TTS model, which provides efficient text-to-speech synthesis optimized specifically for Apple Silicon architecture.

Can I control voice characteristics like tone and gender during text-to-speech generation?▼

Yes, text-to-speech generation supports customizable voice characteristics through detailed parameter control, allowing you to specify voice instructions and language selection for tailored audio output.

What parameters should I tune to optimize speech synthesis speed and audio quality?▼

To optimize speech synthesis, adjust sampling parameters like temperature, top_k, top_p, repetition_penalty, and max_tokens to balance RTF performance, audio length, and overall voice quality.

Does Qwen3-TTS require mlx-audio and soundfile dependencies to work?▼

Yes, generating speech with Qwen3-TTS requires the mlx-audio and soundfile dependencies to handle the audio processing framework and output file writing on Mac MLX hardware.

Why does my generated audio file cut off before the text finishes?▼

Generated audio may cut off if the max_tokens parameter is set too low; dynamically adjusting this value ensures optimal audio length to fully cover the input text.