LibreAI / Audio / metavoice-src
// audio · metavoiceio/metavoice-src

metavoice-src

MetaVoice-1B: a 1.2B-parameter foundation model for emotional, zero-shot text-to-speech

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

Project facts

metavoice-src is an open-source audio project by metavoiceio (metavoiceio/metavoice-src on GitHub). It has 4,205 GitHub stars and 689 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 30 July 2024.

GitHub stars
4,205
Forks
689
License
Apache-2.0
Last updated on GitHub
30 July 2024
Category
Audio
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Check your hardware

    Confirm a GPU with at least 12 GB VRAM and Python 3.10–3.11.

  2. Clone and install

    Clone the repo and install with Poetry (recommended) or pip, including the pinned PyTorch build.

  3. Or use Docker

    Bring up the UI or server service with Docker Compose for the fastest trial.

  4. Synthesize with a reference voice

    Run the interactive inference script and synthesize speech from a short reference clip.

// features

Why people love it

Emotion-aware English TTS

Trained to capture rhythm and tone, not just intelligible speech.

Zero-shot voice cloning

Clone American and British voices from a 30-second reference recording.

Cross-lingual fine-tuning

Adapt to other languages/speakers with fine-tuning on as little as ~1 minute of data (per the project).

Arbitrary-length text

Designed to synthesize long passages, not only short clips.

Interactive and Docker paths

An interactive Python inference session, plus Docker Compose services for a web UI or a server.

Fine-tuning code included

Training entry points for the first-stage LLM ship in the repo.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone the project and enter its directory.

    git clone https://github.com/metavoiceio/metavoice-src.git
    cd metavoice-src
  2. Install with Poetry

    Install dependencies and the pinned PyTorch build as documented.

    pipx install poetry
    poetry install && poetry run pip install torch==2.2.1 torchaudio==2.2.1
  3. Run interactive inference

    Start the inference session, then call tts.synthesise with your text and a reference clip.

    poetry run python -i fam/llm/fast_inference.py
    # then: tts.synthesise(text="Hello world", spk_ref_path="assets/bria.mp3")
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains MetaVoice?

MetaVoice (metavoiceio; themetavoice.xyz) publishes the model and code.

Is MetaVoice-1B free?

The code is Apache-2.0 licensed and the weights are on Hugging Face; check the model card for any additional terms.

Does it need a paid API key?

No — it runs locally on your GPU (12 GB+ VRAM required).

How does it compare to cloud TTS APIs?

Cloud APIs trade control for convenience; MetaVoice-1B gives you a self-hosted foundation model you can fine-tune, with emotion and cloning as its headline features.

How do I get started?

Clone the repo, `poetry install` with the pinned PyTorch, then run the interactive inference script — or `docker-compose up -d ui` for the web UI.

// keep exploring

Similar tools

Audio

index-tts

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

★ 24.4k starsNOASSERTION
View guide →
Audio

vall-e

Unofficial PyTorch implementation of VALL-E, the neural codec language model for zero-shot TTS

★ 3.0k starsMIT
View guide →
Audio

ChatTTS

A generative speech model built for daily dialogue — natural, conversational text-to-speech

★ 39.9k starsAGPL-3.0
View guide →
Audio

bark

Suno's text-prompted generative audio model: speech, music and sound effects from text prompts

★ 39.3k starsMIT
View guide →
Audio

transcribe.cpp

Fast local speech-to-text across 16+ model families, powered by ggml.

★ 2.0k starsMIT
View guide →
Audio

MOSS-TTSD

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

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

Alternatives in Audio

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

Get metavoice-src

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