qwen-tts (--backend qwen)

Runs the qwen-tts qwen-tts-demo server, one model at a time. Installs into its own managed venv, app/envs/qwen.

Run all commands from the project root (next to audiobook.py).

Requirements

• Python 3.12+ (as for the app itself)

Install

python3 -m venv app/envs/qwen
app/envs/qwen/bin/pip install -U qwen-tts

Model weights download from HuggingFace automatically on first server start.

Run the server

Start the demo matching what you want to do:

# Built-in speakers (pick a speaker with --voice in TAG)
app/envs/qwen/bin/qwen-tts-demo Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice --ip 127.0.0.1 --port 7860

# Voice cloning (needs a reference clip)
app/envs/qwen/bin/qwen-tts-demo Qwen/Qwen3-TTS-12Hz-1.7B-Base --ip 127.0.0.1 --port 7860

# Voice design (style described with --instructions in TAG)
app/envs/qwen/bin/qwen-tts-demo Qwen/Qwen3-TTS-12Hz-1.7B-VoiceDesign --ip 127.0.0.1 --port 7860

• Add --no-flash-attn if FlashAttention is not installed.
• For cloning, reference clips of 10-15 seconds of clean speech work best (pass with --clone <wav>).

Use it

python audiobook.py --backend qwen --api-url http://127.0.0.1:7860