Guia do WhisperX
Instalar o WhisperX: ambiente local e diagnóstico
Prepare um ambiente Python isolado, CPU ou GPU compatível e FFmpeg seguindo os requisitos atuais do projeto original.
Equipe WhisperX · Revisado em 15 de outubro de 2026
Leia os requisitos atuais
Consulte o README e as instruções da versão escolhida antes de selecionar Python, PyTorch e CUDA. As dependências mudam; este guia não garante que todos os comandos funcionem no seu sistema.
Use um ambiente isolado
Crie um ambiente virtual novo e salve a versão e as dependências instaladas. Prefira as instruções de uma versão estável quando precisar reproduzir o ambiente.
Confira CPU, GPU e FFmpeg
É possível usar CPU. GPU exige driver e bibliotecas compatíveis; instalar CUDA não basta. FFmpeg lê formatos comuns. Faça o primeiro teste com um arquivo curto.
Configure a identificação de falantes por último
Primeiro confirme a transcrição e o alinhamento. Depois configure o acesso aos modelos conforme as instruções originais, aceite os termos com sua conta e guarde os tokens fora do repositório.
Investigue uma camada por vez
Comando não encontrado: confira o ambiente. Erro de CUDA: confira drivers e bibliotecas. Falta de memória: reduza o lote. Acesso negado: confira permissões. Remova tokens e caminhos privados dos logs compartilhados.
Escolha onde executar
O ambiente local oferece controle sobre configuração e localização dos dados. O serviço hospedado cuida do ambiente para você enviar, revisar e exportar.
python -m venv .venv
# Ative .venv com o comando do seu shell
python -m pip install --upgrade pip
python -m pip install whisperx
whisperx recording.wav --device cpu --compute_type int8