{
 "slug": "qwen3-tts",
 "name": "Qwen3-TTS",
 "author": "Qwen team (Alibaba)",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Multilingual TTS family (10 languages) with preset voices, voice design from text prompts and 3-second voice cloning.",
 "category": {
  "slug": "voiceover",
  "name": "Voiceover (text-to-speech)"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [],
 "logo_url": "https://agentgid.com/media/avatars/qwenlm.png",
 "logo_letter": "Q",
 "links": {
  "repo": "https://github.com/QwenLM/Qwen3-TTS",
  "website": "https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice",
  "api_docs": null
 },
 "preview": null,
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Open weights, free to download.",
   "source": {
    "label": "huggingface.co",
    "url": "https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "Apache-2.0",
   "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute",
   "note": "Apache 2.0 allows commercial use of the models and code.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/QwenLM/Qwen3-TTS/blob/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Required",
   "status": "cond",
   "sub": "Show a credit line",
   "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
   "note": "Voice: Qwen3-TTS (Qwen team, Alibaba), Apache License 2.0",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/QwenLM/Qwen3-TTS/blob/main/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "PyPI package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with pip install qwen-tts.",
   "source": {
    "label": "github.com/QwenLM/Qwen3-TTS",
    "url": "https://github.com/QwenLM/Qwen3-TTS"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "Apache-2.0",
  "url": "https://github.com/QwenLM/Qwen3-TTS/blob/main/LICENSE",
  "summary": "Apache 2.0 license: free to use in personal and paid products, and you may change and share the models and code. When you pass the files on, include the license and keep the notices.",
  "pages_read": 1,
  "rules": [
   "Apache-2.0 weights and code; commercial use and products allowed.",
   "When redistributing the weights or code, include the license and keep notices.",
   "No credit is required inside the generated audio."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/QwenLM/Qwen3-TTS/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Required",
    "status": "cond",
    "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/QwenLM/Qwen3-TTS/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/QwenLM/Qwen3-TTS/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/QwenLM/Qwen3-TTS/blob/main/LICENSE"
    },
    "note": "Passing on the weights or code is allowed with the license copy and notices kept."
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-10-25",
  "commercial_use_page": "https://agentgid.com/assets/qwen3-tts/commercial-use/"
 },
 "overview": {
  "heading": "Qwen3-TTS: open voices that read your text aloud",
  "body": "Qwen3-TTS is a free, open family of AI voice models from the Qwen team at Alibaba that turns written text into natural speech. It speaks 10 languages, including English, Russian and Chinese. You can pick a ready voice, describe a new voice in words, or copy a voice from a 3-second recording, and run it all on your own computer."
 },
 "uses": [
  {
   "title": "Voiceover with a ready voice",
   "text": "Pick one of nine ready voices and get a sound file for a video, a lesson or an app screen. You can add a short note such as \"Very happy.\" to set the mood.",
   "idea": false,
   "image": null
  },
  {
   "title": "Describe a new voice in words",
   "text": "Write how the voice should sound, such as age, tone and emotion, and the model makes a matching voice. Handy for game characters or story narrators.",
   "idea": false,
   "image": null
  },
  {
   "title": "Speak in a voice from a short clip",
   "text": "Give a few seconds of recorded speech and its words, and new text is read in that voice. Use your own voice or one you have permission to use.",
   "idea": false,
   "image": null
  },
  {
   "title": "One character voice for many lines",
   "text": "Design a voice once, save it as a reusable sample, and use it for every line of a game, comic dub or course, so the character always sounds the same.",
   "idea": false,
   "image": null
  },
  {
   "title": "Try voices in a local web page",
   "text": "Start a small web page on your computer to type text, pick a voice and listen, before writing any code.",
   "idea": false,
   "image": null
  },
  {
   "title": "Read articles aloud in several languages",
   "text": "Add a Listen button to blog posts or help pages and make the audio in the reader's language with the same voice.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "In a fresh Python 3.12 env, install qwen-tts==0.1.1, load Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice and write my script to a wav file with speaker \"Ryan\" in English; keep the license notice if we ship the model files.",
  "install": null,
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "Make a fresh Python 3.12 environment so its pinned packages do not clash with others.",
    "source": "conda create -n qwen3-tts python=3.12 -y\nconda activate qwen3-tts"
   },
   {
    "tab": "Step 2",
    "intro": "Install the qwen-tts package. The model files download by themselves the first time you load a model by name.",
    "source": "pip install -U qwen-tts"
   },
   {
    "tab": "Step 3",
    "intro": "Optionally install FlashAttention 2 to use less graphics memory, if your graphics card supports it.",
    "source": "pip install -U flash-attn --no-build-isolation"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "pip install qwen-tts into an existing project environment",
   "fix": "create a fresh env first (conda create -n qwen3-tts python=3.12)",
   "why": "The package pins exact versions of transformers and accelerate that can clash with other packages.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "attn_implementation=\"flash_attention_2\" with float32 or on unsupported hardware",
   "fix": "load with dtype=torch.bfloat16 (or float16) on a supported GPU, or leave out attn_implementation",
   "why": "FlashAttention 2 only works in half precision on compatible hardware.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "generate_voice_clone(text=..., ref_audio=clip) without ref_text",
   "fix": "pass ref_text with the exact words of the clip, or set x_vector_only_mode=True and accept lower similarity",
   "why": "The clone model expects the transcript of the reference clip.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "calling generate_voice_clone many times with the same ref_audio",
   "fix": "build the prompt once with create_voice_clone_prompt and pass voice_clone_prompt",
   "why": "Reusing the prompt avoids recomputing the reference features every time.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "pip install qwen-tts",
  "repo": "https://github.com/QwenLM/Qwen3-TTS",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": null,
  "formats": [],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Voice: Qwen3-TTS (Qwen team, Alibaba), Apache License 2.0",
  "rules_text": "- Qwen3-TTS (Voiceover (text-to-speech)). Multilingual TTS family (10 languages) with preset voices, voice design from text prompts and 3-second voice cloning. Price: free; commercial use OK; credit required.\n  Connect: PyPI qwen-tts.\n  Rule: Apache-2.0 weights and code; commercial use and products allowed.\n  Rule: When redistributing the weights or code, include the license and keep notices.\n  Rule: No credit is required inside the generated audio.\n  License: https://github.com/QwenLM/Qwen3-TTS/blob/main/LICENSE (checked 2026-10-25; details: https://agentgid.com/assets/qwen3-tts/)",
  "agent_md": "https://agentgid.com/assets/qwen3-tts/agent.md",
  "card_json": "https://agentgid.com/assets/qwen3-tts/card.json"
 },
 "popularity": {
  "gid_score": 40,
  "stars": 14511,
  "downloads_7d": 90893,
  "downloads_7d_label": "90.9K",
  "downloads_change_4w_pct": 45.7,
  "eco": "pypi",
  "package": "qwen-tts",
  "repo": "QwenLM/Qwen3-TTS",
  "agent_projects": 1,
  "agent_projects_total": 1606,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2026-04-13",
     46423
    ],
    [
     "2026-04-20",
     46596
    ],
    [
     "2026-04-27",
     48852
    ],
    [
     "2026-05-04",
     66663
    ],
    [
     "2026-05-11",
     44908
    ],
    [
     "2026-05-18",
     42233
    ],
    [
     "2026-05-25",
     43045
    ],
    [
     "2026-06-01",
     39009
    ],
    [
     "2026-06-08",
     55929
    ],
    [
     "2026-06-15",
     52677
    ],
    [
     "2026-06-22",
     48420
    ],
    [
     "2026-06-29",
     46457
    ],
    [
     "2026-07-06",
     42888
    ],
    [
     "2026-07-13",
     49158
    ],
    [
     "2026-07-20",
     51454
    ],
    [
     "2026-07-27",
     62949
    ],
    [
     "2026-08-03",
     59871
    ],
    [
     "2026-08-10",
     58713
    ],
    [
     "2026-08-17",
     61493
    ],
    [
     "2026-08-24",
     36803
    ],
    [
     "2026-08-31",
     38906
    ],
    [
     "2026-09-07",
     39242
    ],
    [
     "2026-09-14",
     38385
    ],
    [
     "2026-09-21",
     44841
    ],
    [
     "2026-09-28",
     50227
    ],
    [
     "2026-10-05",
     61069
    ],
    [
     "2026-10-12",
     70998
    ],
    [
     "2026-10-19",
     74685
    ],
    [
     "2026-10-26",
     79244
    ],
    [
     "2026-11-02",
     87017
    ],
    [
     "2026-11-09",
     89999
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     14270
    ],
    [
     "2026-11-08",
     14280
    ],
    [
     "2026-11-09",
     14303
    ],
    [
     "2026-11-10",
     14331
    ],
    [
     "2026-11-11",
     14355
    ],
    [
     "2026-11-12",
     14372
    ],
    [
     "2026-11-13",
     14391
    ],
    [
     "2026-11-14",
     14402
    ],
    [
     "2026-11-15",
     14419
    ],
    [
     "2026-11-16",
     14438
    ],
    [
     "2026-11-17",
     14466
    ],
    [
     "2026-11-18",
     14498
    ],
    [
     "2026-11-19",
     14511
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "qwen3-tts",
   "name": "Qwen3-TTS",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "PyPI"
  },
  {
   "slug": "chatterbox",
   "name": "Chatterbox",
   "why": "Pick Chatterbox when you want an MIT-licensed voice model with cloning in 23 languages and a built-in audio watermark.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "PyPI"
  },
  {
   "slug": "cosyvoice-3",
   "name": "CosyVoice 3",
   "why": "Pick CosyVoice 3 when you need many Chinese dialects as well as voice cloning and streaming.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  },
  {
   "slug": "piper",
   "name": "Piper",
   "why": "Pick Piper for a small, fast voice engine that runs on modest computers, with voices under their own licenses.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "PyPI"
  },
  {
   "slug": "voicestudio",
   "name": "VoiceStudio",
   "why": "Local desktop app for voice cloning, voice design, video dubbing, dictation and transcription in 646 languages, with a local API and an MCP server for agents.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "MCP, API"
  },
  {
   "slug": "vibevoice",
   "name": "VibeVoice",
   "why": "Long-form multi-speaker TTS for podcast-style dialogue, up to 90 minutes and 4 speakers, in English and Chinese.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  }
 ],
 "faq": [
  {
   "q": "Does it speak Russian?",
   "a": "Yes. Russian is one of the ten languages, together with English, Chinese, Japanese, Korean, German, French, Portuguese, Spanish and Italian."
  },
  {
   "q": "Can I use the voices in a paid app or video?",
   "a": "Yes. The models and code are under Apache 2.0, which allows commercial use; keep the license when you pass files on."
  },
  {
   "q": "How long a recording do I need to copy a voice?",
   "a": "About 3 seconds of speech, together with the words spoken in it."
  },
  {
   "q": "Can I copy a voice without typing out the words of the sample?",
   "a": "Yes, with x_vector_only_mode=True, but the copy may sound less like the original."
  }
 ],
 "at_a_glance": {
  "latest_version": "0.1.1",
  "last_commit": "2026-03-17",
  "runtime": "Python 3.9+ (docs suggest a fresh Python 3.12 env); pins transformers==4.57.3 and accelerate==1.12.0; NVIDIA GPU in the examples (device_map=\"cuda:0\"), FlashAttention 2 optional",
  "key_needed": false
 },
 "good_to_know": [
  "The examples run on an NVIDIA graphics card. Even the small 0.6B model file is about 1.8 GB, so plan disk space and memory.",
  "Mood notes such as \"Very happy.\" work only with the larger 1.7B models. The small 0.6B voices and the copy-a-voice models do not take them.",
  "Each ready voice sounds best in its own language, though every voice can speak all ten.",
  "The page for copying a voice needs a secure connection when opened from another machine, or the browser blocks the microphone.",
  "A paid hosted version runs on Alibaba Cloud if you do not want to run the models yourself."
 ],
 "stack_snippets": [],
 "claims": [
  "End-to-end synthesis latency as low as 97ms."
 ],
 "checked": {
  "license_read": "2026-10-25",
  "overview_checked": "2026-11-10",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "github.com/QwenLM/Qwen3-TTS",
    "url": "https://github.com/QwenLM/Qwen3-TTS"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/QwenLM/Qwen3-TTS/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/QwenLM/Qwen3-TTS/blob/main/LICENSE"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/Qwen/Qwen3-TTS-12Hz-1.7B-CustomVoice/raw/main/README.md"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/api/models/Qwen/Qwen3-TTS-12Hz-0.6B-CustomVoice/tree/main"
   },
   {
    "label": "pypi.org/pypi/qwen-tts/json",
    "url": "https://pypi.org/pypi/qwen-tts/json"
   },
   {
    "label": "pypi.org/project/qwen-tts",
    "url": "https://pypi.org/project/qwen-tts/"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/qwen3-tts/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
