Communitygithub.com

skills.volces.com/openai-whisper-local

Habilidade de agente para transcrição e tradução de áudio local usando o modelo OpenAI Whisper, disponível em skills.volces.com/openai-whisper-local.

O que é openai-whisper-local?

Esta habilidade permite que agentes de IA, como Claude Code, Cursor ou Codex, realizem transcrição e tradução de áudio localmente utilizando o modelo OpenAI Whisper. Ela é especialmente útil para desenvolvedores que precisam processar arquivos de áudio sem depender de serviços externos, garantindo privacidade dos dados e funcionamento offline. A habilidade suporta a execução direta do Whisper via linha de comando, com opções para entrada de áudio em diversos formatos, seleção de modelo (tiny, base, small, medium, large) e ajuste de parâmetros como idioma e temperatura. Inclui também funcionalidades para download automático dos modelos, suporte a GPU via CUDA, e formatação da saída (texto simples, SRT, VTT, TSV, JSON). A implementação segue as boas práticas de modularidade, com instruções claras de instalação e uso, tornando-a uma ferramenta versátil para pipelines de processamento de áudio em aplicações de IA.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add skills.volces.com/openai-whisper-local

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que openai-whisper-local faz?

Habilidade de agente para transcrição e tradução de áudio local usando o modelo OpenAI Whisper. Disponível em skills.volces.com/openai-whisper-local.

Visão Geral

O OpenAI Whisper é um sistema de reconhecimento de fala de propósito geral. Ele é treinado em um grande conjunto de dados de áudio multilíngue e multitarefa e pode transcrever ou traduzir áudio para texto. Esta habilidade permite que agentes de IA executem o Whisper localmente, sem depender de serviços de nuvem.

Recursos

  • Transcrição: Converte fala em texto no mesmo idioma.
  • Tradução: Traduz fala de qualquer idioma para o inglês.
  • Suporte multilíngue: Reconhece mais de 90 idiomas.
  • Detecção de idioma: Detecta automaticamente o idioma falado.
  • Formatos de saída: Suporta saída em texto simples, SRT, VTT, TSV e JSON.
  • Execução local: Garante privacidade dos dados e funcionamento offline.

Pré-requisitos

  • Python 3.8 ou superior
  • pip para instalar dependências
  • (Opcional) GPU NVIDIA com CUDA para aceleração

Instalação

Para usar esta habilidade, instale o pacote openai-whisper:

pip install openai-whisper

Além disso, instale o ffmpeg (necessário para processamento de áudio):

  • macOS: brew install ffmpeg
  • Ubuntu/Debian: sudo apt update && sudo apt install ffmpeg
  • Windows: Baixe de ffmpeg.org e adicione ao PATH

Uso Básico

Transcrever um arquivo de áudio

whisper audio.mp3

Transcrever com seleção de modelo

whisper audio.mp3 --model medium

Traduzir áudio para inglês

whisper audio.mp3 --task translate

Especificar idioma de entrada

whisper audio.mp3 --language pt

Salvar saída em formato específico

whisper audio.mp3 --output_format srt

Parâmetros

ParâmetroDescriçãoPadrão
--modelTamanho do modelo: tiny, base, small, medium, largesmall
--taskTarefa: transcribe ou translatetranscribe
--languageCódigo do idioma (ex.: en, pt, zh)None (auto-detecção)
--output_formatFormato de saída: txt, srt, vtt, tsv, jsonall
--temperatureTemperatura para amostragem0
--deviceDispositivo: cpu ou cudacpu

Exemplos Avançados

Usar GPU com CUDA

whisper audio.wav --device cuda --model large

Processar múltiplos arquivos

whisper audio1.mp3 audio2.mp3 audio3.mp3

Salvar saída em diretório específico

whisper audio.mp3 --output_dir ./transcricoes

Pular detecção de idioma e forçar idioma

whisper audio.mp3 --language pt --task transcribe

Solução de Problemas

Erro: ffmpeg not found

Certifique-se de que o ffmpeg está instalado e acessível no PATH do sistema.

Erro: CUDA out of memory

Use um modelo menor (tiny, base) ou reduza o tamanho do áudio.

Modelo demorando muito

Considere usar um modelo menor ou ativar a aceleração por GPU.

Informações Adicionais

Para documentação completa, acesse: github.com/openai/whisper

Licença

Esta habilidade utiliza o modelo OpenAI Whisper, que é distribuído sob a licença MIT.

Habilidades Relacionadas