Repolode
hexgrad

hexgrad/kokoro

Biblioteca Python de inferência para o Kokoro-82M, um modelo de conversão de texto em fala com pesos abertos e 82 milhões de parâmetros.

Estrelas
9,474
Forks
1,054
Issues abertas
214
Último commit
ano passado

O que é?

kokoro é uma biblioteca de inferência para o Kokoro-82M, um modelo leve de conversão de texto em fala com pesos abertos. Ele pode ser instalado pelo PyPI com pip e oferece a classe KPipeline, que converte texto em áudio e gera grafemas, fonemas e trechos de áudio para cada segmento da entrada.

A biblioteca oferece suporte a vários idiomas por meio de códigos de idioma, incluindo inglês americano e britânico, espanhol, francês, hindi, italiano, português brasileiro e, com extras opcionais, japonês e chinês mandarim. As vozes são selecionadas pelo nome, como af_heart, ou podem ser carregadas diretamente de um arquivo de tensor de voz. O fallback para palavras fora do vocabulário em inglês e o suporte a alguns outros idiomas dependem do espeak-ng, cuja instalação é abordada nas instruções para Linux, macOS e Windows.

Em Macs com Apple Silicon, definir PYTORCH_ENABLE_MPS_FALLBACK=1 habilita a aceleração por GPU. O projeto também fornece um arquivo de ambiente conda para resolver problemas de dependências.

Recursos principais

  • 01Pode ser instalado pelo PyPI com pip e é usado por meio da classe KPipeline
  • 02Gera grafemas, fonemas e áudio para cada segmento de texto
  • 03Oferece suporte a vários idiomas europeus e asiáticos, além de variantes do inglês, por meio de códigos de idioma
  • 04Permite escolher vozes pelo nome ou carregar diretamente um tensor de voz
  • 05Usa espeak-ng para o fallback em inglês e para alguns idiomas
  • 06Habilita a aceleração por GPU em Apple Silicon usando PyTorch MPS

Casos de uso

  • Adicionar saída de voz a aplicações ou notebooks Python
  • Gerar narrações ou locuções a partir de textos longos divididos em segmentos
  • Executar um modelo TTS leve em hardware pessoal ou em serviços de produção

Início rápido

  1. 1

    Instale a biblioteca pelo PyPI

    pip install kokoro>=0.9.4 soundfile
  2. 2

    Instale o espeak-ng (usado como alternativa para o inglês e para alguns idiomas que não são inglês)

    apt-get -qq -y install espeak-ng
  3. 3

    Crie um pipeline e gere fala a partir de texto

    pipeline = KPipeline(lang_code='a')

Antes de usar

  • Idiomas que não são inglês e alguns recursos exigem etapas extras, como instalar o espeak-ng ou os extras do misaki.
  • Usuários do Windows precisam instalar o espeak-ng manualmente pela página de lançamentos.

Tópicos

Perguntas frequentes

O que é kokoro?
Biblioteca Python de inferência para o Kokoro-82M, um modelo de conversão de texto em fala com pesos abertos e 82 milhões de parâmetros. kokoro é uma biblioteca de inferência para o Kokoro-82M, um modelo leve de conversão de texto em fala com pesos abertos. Ele pode ser instalado pelo PyPI com pip e oferece a classe KPipeline, que converte texto em áudio e gera grafemas, fonemas e trechos de áudio para cada segmento da entrada.
kokoro é gratuito? Qual é a licença?
kokoro é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
kokoro ainda é mantido?
Sem commits há mais de 6 meses. O último commit de kokoro foi em 6 de ago. de 2025.
Para que posso usar kokoro?
Adicionar saída de voz a aplicações ou notebooks Python Gerar narrações ou locuções a partir de textos longos divididos em segmentos Executar um modelo TTS leve em hardware pessoal ou em serviços de produção
Como instalar kokoro?
Instale a biblioteca pelo PyPI: pip install kokoro>=0.9.4 soundfile Instale o espeak-ng (usado como alternativa para o inglês e para alguns idiomas que não são inglês): apt-get -qq -y install espeak-ng Crie um pipeline e gere fala a partir de texto: pipeline = KPipeline(lang_code='a')
Onde consigo kokoro?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/hexgrad/kokoro

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

Projetos relacionados