{
 "slug": "cosyvoice-3",
 "name": "CosyVoice 3",
 "author": "FunAudioLLM (Alibaba)",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "LLM-based zero-shot TTS with voice cloning in 9 languages and 18+ Chinese dialects, plus streaming and instruction control.",
 "category": {
  "slug": "voiceover",
  "name": "Voiceover (text-to-speech)"
 },
 "tags": [
  "Open source"
 ],
 "styles": [],
 "logo_url": "https://agentgid.com/media/avatars/qwenaudio.png",
 "logo_letter": "C",
 "links": {
  "repo": "https://github.com/QwenAudio/CosyVoice",
  "website": "https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512",
  "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/FunAudioLLM/Fun-CosyVoice3-0.5B-2512"
   },
   "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 code and, per the model card, the weights.",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/QwenAudio/CosyVoice/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": "Speech: CosyVoice 3 by FunAudioLLM (Apache-2.0)",
   "source": {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/QwenAudio/CosyVoice/blob/main/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "Download",
   "status": "info",
   "sub": "Files by hand",
   "quote": null,
   "note": "There is no package or API. Files are downloaded by hand from the official site.",
   "source": {
    "label": "github.com/QwenAudio/CosyVoice",
    "url": "https://github.com/QwenAudio/CosyVoice"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "Apache-2.0",
  "url": "https://github.com/QwenAudio/CosyVoice/blob/main/LICENSE",
  "summary": "Free for personal and paid products, and you may change and share it. Keep the license and notices when you pass the code or model files on.",
  "pages_read": 1,
  "rules": [
   "Apache-2.0 weights (per the model card) and code; commercial use and products allowed.",
   "When redistributing the weights or code, include the license and keep notices.",
   "The GitHub README notes its demo content is for academic purposes only; this covers the samples, not the model."
  ],
  "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/QwenAudio/CosyVoice/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/QwenAudio/CosyVoice/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/QwenAudio/CosyVoice/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "You must cause any modified files to carry prominent notices stating that You changed the files",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/QwenAudio/CosyVoice/blob/main/LICENSE"
    },
    "note": "Passing the files on is allowed with the license; changed files must say that they were changed."
   },
   {
    "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/cosyvoice-3/commercial-use/"
 },
 "overview": {
  "heading": "CosyVoice 3: open speech model with voice cloning",
  "body": "CosyVoice 3 is a free AI model from Alibaba's FunAudioLLM team that reads text aloud in a natural voice. It can copy a voice from a short sample clip and speaks 9 languages plus many Chinese dialects. You run it on your own computer, and its Apache-2.0 license allows paid products."
 },
 "uses": [
  {
   "title": "A voice copied from a short clip",
   "text": "Give the model a short recording of a voice and its transcript, and it reads any new text in that voice. Use it for your own voice or one you have permission to use.",
   "idea": false,
   "image": null
  },
  {
   "title": "Voiceovers in several languages",
   "text": "Make narration for videos, lessons or app tours in Chinese, English, Japanese, Korean, German, Spanish, French, Italian or Russian, even in the same cloned voice.",
   "idea": false,
   "image": null
  },
  {
   "title": "Tone, speed and dialect on request",
   "text": "Ask in plain words for a dialect such as Cantonese, a faster pace, an emotion or a louder voice, written into the prompt.",
   "idea": false,
   "image": null
  },
  {
   "title": "Spoken replies that start fast",
   "text": "For a voice assistant, feed text in pieces and play the sound while it is still being made, so the reply starts almost at once.",
   "idea": false,
   "image": null
  },
  {
   "title": "Fixing hard-to-say words",
   "text": "When a name or term comes out wrong, spell its sound out in the text, with Chinese Pinyin or English phoneme codes.",
   "idea": false,
   "image": null
  },
  {
   "title": "Your own speech server",
   "text": "Run the model as a small web service in a container on a machine with an NVIDIA card, and call it from your apps.",
   "idea": false,
   "image": null
  }
 ],
 "start": {
  "prompt": "Set up CosyVoice 3 from its GitHub repository (clone with submodules, Python 3.10), download FunAudioLLM/Fun-CosyVoice3-0.5B-2512 to pretrained_models/, install the requirements from the normal PyPI index, and write a script that reads lines from script.txt and saves one WAV per line in my voice from me.wav with its transcript.",
  "install": null,
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "Get the code with its sub-modules and set up a Python 3.10 environment with conda, as the README shows.",
    "source": "git clone --recursive https://github.com/FunAudioLLM/CosyVoice.git\ncd CosyVoice\nconda create -n cosyvoice -y python=3.10\nconda activate cosyvoice"
   },
   {
    "tab": "Step 2",
    "intro": "Download the CosyVoice 3 model files from Hugging Face.",
    "source": "from huggingface_hub import snapshot_download\nsnapshot_download('FunAudioLLM/Fun-CosyVoice3-0.5B-2512', local_dir='pretrained_models/Fun-CosyVoice3-0.5B')"
   },
   {
    "tab": "Step 3",
    "intro": "Load the model with AutoModel and call inference_zero_shot (see the voice cloning recipe above), or run example.py.",
    "source": "python example.py"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "git clone without --recursive, then importing cosyvoice",
   "fix": "git clone --recursive, or run git submodule update --init --recursive, and keep sys.path.append('third_party/Matcha-TTS')",
   "why": "The code relies on the Matcha-TTS sub-module, which a plain clone leaves empty.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com copied as is",
   "fix": "pip install -r requirements.txt from your normal package index, unless the person chose that mirror",
   "why": "The README command pulls packages from a third-party mirror and marks it as trusted.",
   "dont_code": true,
   "fix_code": true
  },
  {
   "dont": "Passing only the transcript of the voice sample as prompt_text to CosyVoice 3",
   "fix": "Start the prompt text with 'You are a helpful assistant.<|endofprompt|>' and put the transcript after it",
   "why": "Every CosyVoice 3 example in the docs builds the prompt this way.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Feeding Japanese text in kanji or hiragana",
   "fix": "Convert Japanese text to katakana first",
   "why": "The example script says Japanese must be translated to katakana.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Installing vllm 0.10.x for faster CosyVoice 3",
   "fix": "Use vLLM 0.11.x or newer, or 0.9.0, in a separate environment",
   "why": "Versions before 0.9.0 do not work and the ones in between are not tested.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": false,
  "self_serve_text": null,
  "install": null,
  "repo": "https://github.com/QwenAudio/CosyVoice",
  "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": "Speech: CosyVoice 3 by FunAudioLLM (Apache-2.0)",
  "rules_text": "- CosyVoice 3 (Voiceover (text-to-speech)). LLM-based zero-shot TTS with voice cloning in 9 languages and 18+ Chinese dialects, plus streaming and instruction control. Price: free; commercial use OK; credit required.\n  Connect: download from https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512 (no API).\n  Rule: Apache-2.0 weights (per the model card) and code; commercial use and products allowed.\n  Rule: When redistributing the weights or code, include the license and keep notices.\n  Rule: The GitHub README notes its demo content is for academic purposes only; this covers the samples, not the model.\n  License: https://github.com/QwenAudio/CosyVoice/blob/main/LICENSE (checked 2026-10-25; details: https://agentgid.com/assets/cosyvoice-3/)",
  "agent_md": "https://agentgid.com/assets/cosyvoice-3/agent.md",
  "card_json": "https://agentgid.com/assets/cosyvoice-3/card.json"
 },
 "popularity": {
  "gid_score": 43,
  "stars": 24446,
  "downloads_7d": null,
  "downloads_7d_label": null,
  "downloads_change_4w_pct": null,
  "eco": null,
  "package": null,
  "repo": "QwenAudio/CosyVoice",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [],
   "stars": [
    [
     "2026-11-07",
     24327
    ],
    [
     "2026-11-08",
     24329
    ],
    [
     "2026-11-09",
     24339
    ],
    [
     "2026-11-10",
     24353
    ],
    [
     "2026-11-11",
     24362
    ],
    [
     "2026-11-12",
     24370
    ],
    [
     "2026-11-13",
     24386
    ],
    [
     "2026-11-14",
     24392
    ],
    [
     "2026-11-15",
     24409
    ],
    [
     "2026-11-16",
     24415
    ],
    [
     "2026-11-17",
     24430
    ],
    [
     "2026-11-18",
     24434
    ],
    [
     "2026-11-19",
     24446
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "cosyvoice-3",
   "name": "CosyVoice 3",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  },
  {
   "slug": "chatterbox",
   "name": "Chatterbox",
   "why": "Pick Chatterbox for an MIT-licensed cloning model with 23 languages and a built-in audio watermark.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "PyPI"
  },
  {
   "slug": "omnivoice",
   "name": "OmniVoice",
   "why": "Pick OmniVoice when you need far more languages (600+), keeping in mind its tokenizer license limits.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Non-commercial",
    "status": "no"
   },
   "access": "PyPI"
  },
  {
   "slug": "qwen3-tts",
   "name": "Qwen3-TTS",
   "why": "Pick Qwen3-TTS for ready preset voices and voice design from a text description in 10 languages.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "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": "Can I use CosyVoice 3 in a paid app?",
   "a": "Yes. The model card lists the Apache-2.0 license, which allows commercial use; keep the license with copies you pass on."
  },
  {
   "q": "Which languages does it speak?",
   "a": "Chinese, English, Japanese, Korean, German, Spanish, French, Italian and Russian, plus 18 or more Chinese dialects and accents."
  },
  {
   "q": "Do I need an account to download it?",
   "a": "No. The Hugging Face model is not gated, so the files download without signing in."
  },
  {
   "q": "Can it speak while it is still generating?",
   "a": "Yes. It supports streaming text in and audio out, which the team reports at latency as low as 150 ms."
  }
 ],
 "at_a_glance": {
  "latest_version": "Fun-CosyVoice3-0.5B-2512 (Hugging Face files last updated 2026-02-03)",
  "last_commit": "2026-05-25",
  "runtime": "Python 3.10 in a conda environment, per the README; the optional ttsfrd text helper is a Linux x86_64 wheel",
  "key_needed": false
 },
 "good_to_know": [
  "The setup is for developers. It means getting the code with git, a conda environment with Python 3.10 and a separate model download.",
  "The optional text helper package is offered only as a Linux file, so on other systems the default helper is used.",
  "Japanese text has to be written in katakana first, as the example script notes.",
  "The sample audio on the project pages is for academic demonstration only; this note is about the demos, not the model license."
 ],
 "stack_snippets": [],
 "claims": [
  "Latency as low as 150ms with streaming",
  "9 common languages and 18+ Chinese dialects or accents",
  "Better than CosyVoice 2.0 in content consistency, speaker similarity and naturalness, as the team reports"
 ],
 "checked": {
  "license_read": "2026-10-25",
  "overview_checked": "2026-11-10",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512/raw/main/README.md"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/api/models/FunAudioLLM/Fun-CosyVoice3-0.5B-2512"
   },
   {
    "label": "github.com/QwenAudio/CosyVoice",
    "url": "https://github.com/QwenAudio/CosyVoice"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/QwenAudio/CosyVoice/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/QwenAudio/CosyVoice/blob/main/LICENSE"
   },
   {
    "label": "github.com/QwenAudio/CosyVoice/blob/main/example.py",
    "url": "https://github.com/QwenAudio/CosyVoice/blob/main/example.py"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/cosyvoice-3/",
 "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."
}
