{"library":"qwen-tts","title":"Qwen-TTS","description":"Qwen-TTS is a powerful text-to-speech (TTS) synthesis library developed by the Qwen team (Alibaba Cloud). It enables high-quality speech generation from text, supporting various languages and speaking styles. The library is currently at version 0.1.1 and is under active development, with updates typically coinciding with major model releases or feature improvements.","language":"python","status":"active","last_verified":"Sun May 17","install":{"commands":["pip install qwen-tts","pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118"],"cli":null},"imports":["from qwen_tts.models import QwenTTS","from qwen_tts.frontend import get_frontend"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import torch\nimport soundfile as sf\nfrom qwen_tts.frontend import get_frontend\nfrom qwen_tts.models import QwenTTS\n\n# Define text and style for synthesis\ntext = \"Hello, this is a test from Qwen TTS, demonstrating speech synthesis.\"\nlanguage = \"en\"\nstyle_name = \"neutral\" # Other options: 'happy', 'sad', etc.\n\n# Determine device for model loading (GPU if available, else CPU)\ndevice = 'cuda' if torch.cuda.is_available() else 'cpu'\nprint(f\"Attempting to load model on: {device}\")\n\n# Load the QwenTTS model from Hugging Face Hub\ntry:\n    model = QwenTTS.from_pretrained('Qwen/Qwen3-TTS', device=device)\nexcept Exception as e:\n    print(f\"Failed to load model on {device}: {e}. Retrying with 'cpu'.\")\n    device = 'cpu'\n    model = QwenTTS.from_pretrained('Qwen/Qwen3-TTS', device=device)\n\n# Initialize the frontend for text processing\n# The exp_name is retrieved from the loaded model's hyperparameters\nfrontend = get_frontend(model.hparams.data.exp_name)\n\n# Get text and style tokens from the frontend\ntext_token, style_token = frontend.get_text_token_and_style_token(\n    text=text,\n    language=language,\n    style_name=style_name\n)\n\n# Synthesize speech using the model\noutput = model.synthesize(text_token, style_token)\nwav = output['wav'][0].cpu().numpy() # Extract waveform and move to CPU\nsampling_rate = model.hparams.data.sampling_rate\n\n# Save the synthesized audio to a WAV file\noutput_filename = \"qwen_tts_output.wav\"\nsf.write(output_filename, wav, sampling_rate)\nprint(f\"Speech synthesized and saved to {output_filename}\")\n","lang":"python","description":"This quickstart demonstrates how to load the Qwen-TTS model, prepare text with its frontend, synthesize speech, and save the output to a WAV file. It includes robust device selection (GPU/CPU) and handles common initialization steps.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":null,"pypi_latest":"0.1.1","is_stale":null,"summary":{"python_range":"3.10–3.9","success_rate":25,"avg_install_s":84.2,"avg_import_s":null,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"qwen-tts","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"torch","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":0.1,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"qwen-tts","exit_code":1,"wheel_type":null,"failure_reason":"timeout","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"torch","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":87.3,"import_time_s":null,"mem_mb":null,"disk_size":"8.2G"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"qwen-tts","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"torch","exit_code":1,"wheel_type":null,"failure_reason":"timeout","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"qwen-tts","exit_code":1,"wheel_type":null,"failure_reason":"timeout","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"torch","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":83,"import_time_s":null,"mem_mb":null,"disk_size":"8.3G"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"qwen-tts","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"torch","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":0.1,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"qwen-tts","exit_code":1,"wheel_type":null,"failure_reason":"timeout","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"torch","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":74.5,"import_time_s":null,"mem_mb":null,"disk_size":"8.3G"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"qwen-tts","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"torch","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"qwen-tts","exit_code":1,"wheel_type":null,"failure_reason":"timeout","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"torch","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":79.9,"import_time_s":null,"mem_mb":null,"disk_size":"8.3G"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"qwen-tts","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"torch","exit_code":1,"wheel_type":null,"failure_reason":"timeout","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"qwen-tts","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":3.6,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"torch","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":96.3,"import_time_s":null,"mem_mb":null,"disk_size":"8.2G"}]}}