LibreAI / Audio / CosyVoice
// audio · QwenAudio/CosyVoice

CosyVoice

CosyVoice: multilingual voice generation with zero-shot cloning, streaming and fine-tuning

★ 23.9k stars⑂ 2.7k forksApache-2.0updated 2026-05
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

CosyVoice is an open-source audio project by QwenAudio (QwenAudio/CosyVoice on GitHub). It has 23,892 GitHub stars and 2,723 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 25 May 2026.

GitHub stars
23,892
Forks
2,723
License
Apache-2.0
Last updated on GitHub
25 May 2026
Category
Audio
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide what you want to achieve with CosyVoice and check the README on GitHub for requirements before installing.

  2. Get the code

    Clone the repository from GitHub (or take the packaged install route in step 3 if the README offers one).

  3. Install and configure

    Follow the project's documented install commands — the Run section below lists the exact ones — and add any required API keys or models.

  4. Run your first task

    Work through the README's quickstart example end to end, then adapt it to your own project or data.

// features

Why people love it

Multilingual generation

Models cover Chinese, English, Japanese, Korean, Cantonese and more, including cross-lingual cloning.

Zero-shot and SFT/instruct modes

Model variants support zero-shot cloning, supervised fine-tuned voices and instruction-controlled synthesis.

Full-stack: train and deploy

Beyond inference, the repo includes training/fine-tuning code and deployment paths.

Serving options

Run inference through vLLM for throughput, or serve via gRPC/FastAPI examples.

Streaming-friendly architecture

The CosyVoice line is designed for low-latency, streaming TTS use cases.

Multiple model sizes

A model zoo (including 300M-class models) lets you balance quality against hardware.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone with submodules, as the README's install section specifies (note the repo also lives under FunAudioLLM). The README asks for a recursive clone for submodules: run `git submodule update --init --recursive` after cloning.

    git clone https://github.com/QwenAudio/CosyVoice.git
    cd CosyVoice
  2. Install requirements

    Install the Python dependencies from requirements.txt (the README suggests a mirror for faster downloads in China).

    pip install -r requirements.txt
  3. Download a model and run inference

    Download a CosyVoice model with the ModelScope or Hugging Face SDK snippet from the README, then run the basic-usage example for SFT, instruct or zero-shot inference.

    # see the README 'Model download' and 'Basic Usage' sections for the exact snippets
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains CosyVoice?

CosyVoice is maintained by the QwenAudio organization/account on GitHub, together with open-source contributors, in the public repository QwenAudio/CosyVoice.

Is CosyVoice free to use?

Yes — the code is open source under the Apache-2.0 license. You can use, modify and redistribute it under that license's terms.

Does CosyVoice need a paid API key?

No API key — models download from ModelScope/Hugging Face and run on your GPU; budget for GPU compute for real-time use.

How does CosyVoice compare to OpenVoice?

OpenVoice focuses on instant cloning simplicity under MIT; CosyVoice offers a broader multilingual model family with training and production serving paths, from an Alibaba research team.

How do I get started with CosyVoice?

Clone the repository from GitHub, follow the install commands in the Run section (taken from the project's README), and complete the documented quickstart example before adapting it to your own use case.

// keep exploring

Similar tools

Audio

MOSS-TTSD

Multilingual long-form dialogue speech with zero-shot voice cloning.

★ 1.4k starsApache-2.0
View guide →
Audio

voice-pro

Gradio WebUI for creators and developers, featuring key TTS (Edge-TTS, kokoro) and zero-shot Voice Cloning (E2 & F5-TTS, CosyVoice), with Whisper audio proce…

★ 13.0k starsGPL-3.0
View guide →
Audio

index-tts

IndexTTS: industrial-level, controllable zero-shot text-to-speech with voice cloning

★ 24.4k starsNOASSERTION
View guide →
Audio

kokoclone

Voice cloning inside Kokoro: natural multilingual speech, your voice.

★ 203 starsApache-2.0
View guide →
Audio

T5Gemma-TTS

Multilingual TTS with voice cloning and duration control, on T5Gemma.

★ 312 starsMIT
View guide →
Audio

VoxCPM

VoxCPM2: tokenizer-free TTS for multilingual speech, creative voice design and true-to-life cloning

★ 38.4k starsApache-2.0
View guide →
// alternatives

Alternatives in Audio

The most-starred other Audio projects in the LibreAI catalogue — the realistic shortlist if CosyVoice is not the right fit.

Get CosyVoice

Free and open — grab the source, star the repo, and start creating.