LibreAI / Audio / gTTS
// audio · pndurette/gTTS

gTTS

gTTS — Python library and CLI that turns text into spoken mp3 via Google Translate's speech API

★ 2.6k stars⑂ 390 forksMITupdated 2026-04
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

gTTS is an open-source audio project by pndurette (pndurette/gTTS on GitHub). It has 2,636 GitHub stars and 390 forks, is released under the MIT license, and was last updated on GitHub on 6 April 2026.

Repository
pndurette/gTTS
GitHub stars
2,636
Forks
390
License
MIT
Last updated on GitHub
6 April 2026
Category
Audio
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide the text, language and output: an mp3 file, bytes for further audio processing, or stdout in a pipeline.

  2. Get gTTS

    pip install gTTS — no credentials or project setup needed.

  3. Configure

    In code, pass the text and language to gTTS(...); optionally add pre-processors for pronunciation fixes.

  4. Run your first synthesis

    Save your first mp3 with tts.save(...) or the gtts-cli command, and play it back.

// features

Why people love it

Library + CLI

Use the gTTS class in Python or the gtts-cli command for one-off conversions.

Long-text tokenizer

A customizable speech-specific sentence tokenizer allows unlimited text lengths while preserving intonation, abbreviations and decimals.

Text pre-processors

Customizable pre-processing hooks can, for example, provide pronunciation corrections.

Flexible output

Write spoken mp3 to a file, a file-like object (bytestring) for further manipulation, or stdout.

Many languages

Language selection follows Google Translate's TTS voices (pass the language code to gTTS).

Zero setup

No API key or cloud project — it calls the public Google Translate speech endpoint (internet required).

Advertisement
// run it

Run it yourself

  1. Clone the repo

    Clone gTTS if you want the source; users install from PyPI in step 2.

    git clone https://github.com/pndurette/gTTS.git
    cd gTTS
  2. Install

    Install gTTS from PyPI.

    pip install gTTS
  3. Synthesize speech

    Use the CLI quickstart, or the three-line Python module example.

    gtts-cli 'hello' --output hello.mp3
    # Python: from gtts import gTTS; gTTS('hello').save('hello.mp3')
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains gTTS?

pndurette (Pierre Nicolas Durette) and contributors maintain it; documentation is at gtts.readthedocs.org.

Is gTTS free?

Yes, MIT-licensed, and the endpoint it uses needs no key. The README warns it relies on an undocumented Google Translate feature, so upstream breaking changes can occur without notice.

Does it need a paid API key?

No key at all — but it does need internet access to reach Google Translate's speech service.

How does it compare to pyttsx3 or Google Cloud TTS?

pyttsx3 works fully offline with system voices; Google Cloud TTS is the official paid API with more voices and an SLA. gTTS sits in between: free and simple, but online and unofficial.

How do I get started?

pip install gTTS, then gtts-cli 'hello' --output hello.mp3.

// keep exploring

Similar tools

Audio

edge-tts

Use Microsoft Edge's online text-to-speech service from Python WITHOUT needing Microsoft Edge or Windows or an API key

★ 12.2k starsCustom
View guide →
Audio

fastrtc

FastRTC turns any Python function into a real-time audio or video stream over WebRTC or WebSockets

★ 4.6k starsMIT
View guide →
Audio

pyttsx3

Offline text-to-speech for Python — uses your operating system's own voices, no internet needed

★ 2.5k starsMPL-2.0
View guide →
Audio

whisper.api

A ready API for speech-to-text with per-user access control.

★ 914 starsMIT
View guide →
Audio

voxt

A macOS voice assistant that turns speech into actions and notes.

★ 853 starsCustom
View guide →
Audio

Mozilla TTS

Mozilla's deep-learning text-to-speech library with Tacotron, Glow-TTS and neural vocoders.

★ 10.2k starsMPL-2.0
View guide →
// alternatives

Alternatives in Audio

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

Get gTTS

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