LibreAI / Audio / MARS5-TTS
// audio · Camb-ai/MARS5-TTS

MARS5-TTS

MARS5 speech model from CAMB.AI — clone a voice from 5 seconds of audio with striking prosody

★ 2.8k stars⑂ 246 forksAGPL-3.0updated 2024-08
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

MARS5-TTS is an open-source audio project by Camb-ai (Camb-ai/MARS5-TTS on GitHub). It has 2,821 GitHub stars and 246 forks, is released under the AGPL-3.0 license, and was last updated on GitHub on 1 August 2024.

GitHub stars
2,821
Forks
246
License
AGPL-3.0
Last updated on GitHub
1 August 2024
Category
Audio
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Gather the text you want spoken and a clean reference recording of the target voice (1–12 seconds; around 6 seconds is optimal) — plus its transcript for best quality.

  2. Get the model

    Install the dependencies with pip; the model itself loads through torch.hub, so cloning is optional (clone if you want the Hugging Face/local path).

  3. Install and configure

    Create an InferenceConfig: choose deep_clone=True with the reference transcript for quality, or False for fast shallow cloning, and tune temperature/top_k if needed.

  4. Run your first synthesis

    Call mars5.tts(...) with your text, reference audio and config, and save the returned 24 kHz audio tensor.

// features

Why people love it

Two-stage AR-NAR pipeline

An autoregressive transformer produces coarse EnCodec features, then a multinomial DDPM model refines the remaining codebooks before vocoding.

5-second voice cloning

Speaker identity comes from a reference clip of 2–12 seconds; no transcript needed for a shallow clone.

Deep clone mode

Providing the reference transcript enables deep cloning — slower, but typically higher quality.

Prosody by punctuation

Trained on raw audio with byte-pair-encoded text, so commas add pauses and capitalization adds emphasis — a natural way to steer delivery.

torch.hub loading

Load AR and NAR models in two lines with torch.hub.load('Camb-ai/mars5-tts', 'mars5_english', trust_repo=True).

Tunable inference

InferenceConfig exposes deep_clone, temperature, top_k, top_p, repetition/frequency penalties and more.

Advertisement
// run it

Run it yourself

  1. Clone the repo

    Clone MARS5-TTS if you want the local/Hugging Face path; torch.hub loading works without cloning.

    git clone https://github.com/Camb-ai/MARS5-TTS.git
    cd MARS5-TTS
  2. Install dependencies

    Install the packages listed in the README (Python >= 3.10, Torch >= 2.0).

    pip install --upgrade torch torchaudio librosa vocos encodec safetensors regex
  3. Load and synthesize

    Load the model from torch.hub and run the tts() call from the README example.

    import torch, librosa
    mars5, config_class = torch.hub.load('Camb-ai/mars5-tts', 'mars5_english', trust_repo=True)
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains MARS5-TTS?

CAMB.AI maintains the model and repo; CAMB.AI also offers commercial dubbing/TTS products on its website.

Is it free?

The repo is AGPL-3.0 licensed, so it is free to use under AGPL terms (including copyleft obligations for network use). Check the license before commercial use.

Does it need a paid API key?

No — inference runs locally in PyTorch; model weights load from torch.hub or Hugging Face.

How does it compare to simpler TTS like gTTS?

gTTS calls a hosted service for standard voices. MARS5 is a local model focused on voice cloning and difficult prosody from a few seconds of reference audio.

How do I get started?

pip install the listed dependencies, load the model with torch.hub, prepare a 2–12s reference clip (plus transcript for deep clone), and call mars5.tts().

// keep exploring

Similar tools

Audio

Real-Time-Voice-Cloning

Clone a voice from 5 seconds of audio and generate arbitrary speech in real time

★ 60.2k starsNOASSERTION
View guide →
Audio

MockingBird

🚀Clone a voice in 5 seconds to generate arbitrary speech in real-time

★ 36.9k starsUnknown
View guide →
Audio

GPA

GPA — one tiny model that does ASR, TTS and voice conversion (General Purpose Audio).

★ 3.1k starsApache-2.0
View guide →
Audio

Fish Speech

Fish Speech — Fish Audio's expressive open text-to-speech and voice cloning: SOTA-quality TTS you can self-host, under the Fish Audio Community License (check terms)

★ 33.3k starsCustom (check repo)
View guide →
Audio

audio-ai-field-guide

A mental-model-first guide from waveforms to voice systems.

★ 130 starsMIT
View guide →
Audio

MOSS-TTS-Nano

MOSS-TTS-Nano: a 0.1B open multilingual speech model that clones voices and streams in real time on CPU

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

Alternatives in Audio

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

Get MARS5-TTS

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