Kokoro TTS

Kokoro TTS é um mecanismo TTS offline baseado no Kokoro-82M modelo. Ele suporta múltiplos idiomas incluindo inglês, japonês e chinês, e roda na CPU sem exigir uma GPU.

Instalação

Existem duas maneiras de instalar o Kokoro TTS: usando UV (recomendado) ou PIP.

Instalar via UV (Recomendado)

UV é um gerenciador de pacotes Python rápido que lida automaticamente com todas as dependências em um ambiente isolado.

Passo 1 - Instalar o UV

Abra PowerShell e execute o seguinte comando:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Para métodos alternativos de instalação, consulte o Guia de Instalação do UV.

Passo 2 - Verificar a Instalação

Após a conclusão da instalação, reinicie o PowerShell e verifique se o UV foi instalado corretamente executando:

uv --version

Você deve ver a versão do UV instalada exibida no terminal.

Passo 3 - Clonar ou Baixar o Repositório

Clonar via Git (recomendado)

Se você tem Git instalado, abra o PowerShell e execute:

git clone https://github.com/remsky/Kokoro-FastAPI.git
cd Kokoro-FastAPI

Baixar como ZIP

Se você não tem o Git instalado, pode baixar o repositório manualmente:

1. Vá para https://github.com/remsky/Kokoro-FastAPI

2. Clique em Código botão, então selecione Download ZIP

3. Extraia o arquivo ZIP baixado para uma pasta de sua escolha

4. Abra o PowerShell, navegue até a pasta extraída:

cd path\to\Kokoro-FastAPI

Passo 4 - Executar o Kokoro TTS

Inicie o servidor Kokoro TTS usando o script de inicialização fornecido para CPU:

.\start-cpu.ps1

O UV instalará automaticamente todas as dependências necessárias na primeira execução.

Instalar via PIP

Se preferir instalar o Kokoro TTS manualmente usando PIP, siga estes passos.

Passo 1 - Clonar ou Baixar o Repositório

Clonar via Git (recomendado)

git clone https://github.com/remsky/Kokoro-FastAPI.git
cd Kokoro-FastAPI

Baixar como ZIP

Se você não tem o Git instalado, pode baixar o repositório manualmente:

1. Vá para https://github.com/remsky/Kokoro-FastAPI

2. Clique em Código botão, então selecione Download ZIP

3. Extraia o arquivo ZIP baixado para uma pasta de sua escolha

4. Abra o PowerShell, navegue até a pasta extraída:

cd path\to\Kokoro-FastAPI

Passo 2 - Instalar Dependências

Instale os pacotes Python necessários usando o PIP:

pip install -r requirements.txt

Passo 3 - Executar o Kokoro TTS

Uma vez que as dependências estejam instaladas, inicie o servidor Kokoro TTS:

python -m uvicorn api.src.main:app --host 0.0.0.0 --port 8880

---

Executando o Servidor Kokoro TTS

Uma vez que o servidor esteja em execução, você pode acessar a interface web em:

http://localhost:8880/web

A documentação da API também está disponível em:

http://localhost:8880/docs

---

Integração com o VNTranslator

Depois que o servidor Kokoro TTS estiver em execução, siga estes passos para conectá-lo ao VNTranslator:

• Vá para Configurações -> Extensões -> Texto para Fala

• Role até a Kokoro TTS seção de configurações

• Insira o Host e Porta do seu servidor Kokoro TTS em execução. Por padrão, estes já estão definidos para:

  • Host: http://localhost

  • Porta: 8880

Certifique-se de que o servidor Kokoro TTS esteja em execução antes de iniciar um jogo no VNTranslator. Se o servidor não estiver em execução, a reprodução TTS não funcionará.

---

Referências

• Repositório Kokoro FastAPI no GitHub

• Modelo Kokoro-82M no Hugging Face

• Guia de Instalação do UV