Repolode
KoljaB

KoljaB/RealtimeTTS

Biblioteca Python que transforma texto, generators e fluxos de tokens de LLM em fala com baixa latência, usando diversos mecanismos TTS locais e na nuvem.

Estrelas
4,051
Forks
415
Issues abertas
126
Último commit
ontem

O que é?

RealtimeTTS é uma biblioteca Python de conversão de texto em fala para aplicações que precisam começar a falar antes que o texto completo esteja pronto. Ela aceita strings simples, generators e fluxos de tokens de LLM e, em seguida, reproduz o áudio localmente, transmite trechos para outro processo ou grava arquivos WAV.

A biblioteca reúne uma ampla variedade de mecanismos em uma única interface: vozes do sistema operacional, APIs na nuvem como OpenAI, Azure e ElevenLabs, serviços web gratuitos e modelos neurais locais, incluindo Coqui XTTS, Kokoro e Piper. É possível encadear mecanismos como alternativas para que a síntese continue caso um deles falhe.

O mecanismo recomendado é o QwenEngine, que executa o Qwen3-TTS localmente em GPUs NVIDIA ou CPUs e oferece clonagem de voz. Um modo de servidor headless disponibiliza o mesmo mecanismo por meio de uma API HTTP compatível com OpenAI.

Recursos principais

  • 01Converte strings, generators e fluxos de tokens de LLM em áudio conforme os dados chegam.
  • 02Oferece suporte a dezenas de mecanismos, entre vozes do sistema, APIs na nuvem e modelos neurais locais.
  • 03Recorre a mecanismos alternativos quando o mecanismo principal falha.
  • 04Oferece reprodução síncrona e assíncrona, com controles para pausar, retomar e parar.
  • 05Grava arquivos WAV e oferece callbacks para texto, trechos de áudio e tempos das palavras.

Casos de uso

  • Reproduzir em voz alta as respostas de LLM enquanto o modelo ainda gera o texto.
  • Criar assistentes de voz ou chatbots com respostas faladas de baixa latência.
  • Gerar arquivos de fala em lote a partir de texto, sem reprodução de áudio local.
  • Experimentar diferentes provedores de TTS usando uma única interface Python.

Início rápido

  1. 1

    Instale o mecanismo do sistema para um primeiro teste local

    pip install "realtimetts[system]"
  2. 2

    No Linux, instale os cabeçalhos do PortAudio antes dos extras do mecanismo tradicional

    sudo apt-get update
  3. 3

    Instale o pacote de desenvolvimento do PortAudio no Linux

    sudo apt-get install python3-dev portaudio19-dev
  4. 4

    Salve o primeiro script de áudio e execute-o para ouvir a fala

Antes de usar

  • Os extras do mecanismo tradicional exigem que PyAudio e PortAudio estejam instalados primeiro no Linux e no macOS.
  • O mecanismo Qwen recomendado requer uma GPU NVIDIA para o modo GPU e Python 3.11 ou 3.12.

Em coleções

Tópicos

Perguntas frequentes

O que é RealtimeTTS?
Biblioteca Python que transforma texto, generators e fluxos de tokens de LLM em fala com baixa latência, usando diversos mecanismos TTS locais e na nuvem. RealtimeTTS é uma biblioteca Python de conversão de texto em fala para aplicações que precisam começar a falar antes que o texto completo esteja pronto. Ela aceita strings simples, generators e fluxos de tokens de LLM e, em seguida, reproduz o áudio localmente, transmite trechos para outro processo ou grava arquivos WAV.
RealtimeTTS é gratuito? Qual é a licença?
RealtimeTTS é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
RealtimeTTS ainda é mantido?
Manutenção ativa. O último commit de RealtimeTTS foi em 6 de nov. de 2026.
Para que posso usar RealtimeTTS?
Reproduzir em voz alta as respostas de LLM enquanto o modelo ainda gera o texto. Criar assistentes de voz ou chatbots com respostas faladas de baixa latência. Gerar arquivos de fala em lote a partir de texto, sem reprodução de áudio local. Experimentar diferentes provedores de TTS usando uma única interface Python.
Como instalar RealtimeTTS?
Instale o mecanismo do sistema para um primeiro teste local: pip install "realtimetts[system]" No Linux, instale os cabeçalhos do PortAudio antes dos extras do mecanismo tradicional: sudo apt-get update Instale o pacote de desenvolvimento do PortAudio no Linux: sudo apt-get install python3-dev portaudio19-dev Salve o primeiro script de áudio e execute-o para ouvir a fala
Onde consigo RealtimeTTS?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/KoljaB/RealtimeTTS

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados