--- name: qwen-tts-75a5897833c8 description: Local text-to-speech using Qwen3-TTS-12Hz-1.7B-CustomVoice. Use when generating audio from text, creating voice messages, or when TTS is requested. Supports 10 languages including Italian, 9 premium speaker voices, and instruction-based voice control (emotion, tone, style). Alternative to cloud-based TTS services like ElevenLabs. Runs entirely offline after initial model download. --- # Qwen TTS Local text-to-speech using Hugging Face's Qwen3-TTS-12Hz-1.7B-CustomVoice model. ## Quick Start Generate speech from text: ```bash scripts/tts.py "Ciao, come va?" -l Italian -o output.wav ``` With voice instruction (emotion/style): ```bash scripts/tts.py "Sono felice!" -i "Parla con entusiasmo" -l Italian -o happy.wav ``` Different speaker: ```bash scripts/tts.py "Hello world" -s Ryan -l English -o hello.wav ``` ## Installation **First-time setup** (one-time): ```bash cd skills/public/qwen-tts bash scripts/setup.sh ``` This creates a local virtual environment and installs `qwen-tts` package (~500MB). **Note:** First synthesis downloads ~1.7GB model from Hugging Face automatically. ## Usage ```bash scripts/tts.py [options] "Text to speak" ``` ### Options - `-o, --output PATH` - Output file path (default: qwen_output.wav) - `-s, --speaker NAME` - Speaker voice (default: Vivian) - `-l, --language LANG` - Language (default: Auto) - `-i, --instruct TEXT` - Voice instruction (emotion, style, tone) - `--list-speakers` - Show available speakers - `--model NAME` - Model name (default: CustomVoice 1.7B) ### Examples **Basic Italian speech:** ```bash scripts/tts.py "Benvenuto nel futuro del text-to-speech" -l Italian -o welcome.wav ``` **With emotion/instruction:** ```bash scripts/tts.py "Sono molto felice di vederti!" -i "Parla con entusiasmo e gioia" -l Italian -o happy.wav ``` **Different speaker:** ```bash scripts/tts.py "Hello, nice to meet you" -s Ryan -l English -o ryan.wav ``` **List available speakers:** ```bash scripts/tts.py --list-speakers ``` ## Available Speakers The CustomVoice model includes 9 premium voices: | Speaker | Language | Description | |---------|----------|-------------| | Vivian | Chinese | Bright, slightly edgy young female | | Serena | Chinese | Warm, gentle young female | | Uncle_Fu | Chinese | Seasoned male, low mellow timbre | | Dylan | Chinese (Beijing) | Youthful Beijing male, clear | | Eric | Chinese (Sichuan) | Lively Chengdu male, husky | | Ryan | English | Dynamic male, rhythmic | | Aiden | English | Sunny American male | | Ono_Anna | Japanese | Playful female, light nimble | | Sohee | Korean | Warm female, rich emotion | **Recommendation:** Use each speaker's native language for best quality, though all speakers support all 10 languages (Chinese, English, Japanese, Korean, German, French, Russian, Portuguese, Spanish, Italian). ## Voice Instructions Use `-i, --instruct` to control emotion, tone, and style: **Italian examples:** - `"Parla con entusiasmo"` - `"Tono serio e professionale"` - `"Voce calma e rilassante"` - `"Leggi come un narratore"` **English examples:** - `"Speak with excitement"` - `"Very happy and energetic"` - `"Calm and soothing voice"` - `"Read like a narrator"` ## Integration with OpenClaw The script outputs the audio file path to stdout (last line), making it compatible with OpenClaw's TTS workflow: ```bash # OpenClaw captures the output path cd skills/public/qwen-tts OUTPUT=$(scripts/tts.py "Ciao" -s Vivian -l Italian -o /tmp/audio.wav 2>/dev/null) # OUTPUT = /tmp/audio.wav ``` ## Performance - **GPU (CUDA):** ~1-3 seconds for short phrases - **CPU:** ~10-30 seconds for short phrases - **Model size:** ~1.7GB (auto-downloads on first run) - **Venv size:** ~500MB (installed dependencies) ## Troubleshooting **Setup fails:** ```bash # Ensure Python 3.10-3.12 is available python3.12 --version # Re-run setup cd skills/public/qwen-tts rm -rf venv bash scripts/setup.sh ``` **Model download slow/fails:** ```bash # Use mirror (China mainland) export HF_ENDPOINT=https://hf-mirror.com scripts/tts.py "Test" -o test.wav ``` **Out of memory (GPU):** The model automatically falls back to CPU if GPU memory insufficient. **Audio quality issues:** - Try different speaker: `--list-speakers` - Add instruction: `-i "Speak clearly and slowly"` - Check language matches text: `-l Italian` for Italian text ## Model Details - **Model:** Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice - **Source:** Hugging Face (https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice) - **License:** Check model card for current license terms - **Sample Rate:** 16kHz - **Output Format:** WAV (uncompressed) --- Source attribution: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/paki81/qwen-tts/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 clawdbot Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/paki81/qwen-tts/SKILL.md Attribution basis: Source repository record Fields of work: Marketing Roles: Content Marketer, Influencer Marketer, Social Media Manager Specialties: API Tools: OpenAI API, Hugging Face Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: def69f0d12877e606f2a6897c67a85bd7159a2f6a1e3a7f44dcb83d83f087823