BladeRunnerYao/codex-voice-to-text-skill

Habilidade do Codex para ditado Whisper local no macOS com push-to-talk.

O que é codex-voice-to-text-skill?

Esta habilidade permite que agentes AI (como Codex) no macOS realizem ditado de voz para texto localmente usando o modelo Whisper da OpenAI, ativado por um atalho de teclado (push-to-talk). É útil para desenvolvedores que desejam inserir código ou comandos por voz sem depender de serviços em nuvem, garantindo privacidade e baixa latência. A habilidade funciona capturando áudio do microfone quando uma tecla é pressionada, transcrevendo-o localmente via Whisper e colando o texto resultante na aplicação ativa. Suporta plataformas macOS com Python 3.8+ e o pacote whisper, e é ideal para uso com Codex, Claude Code ou outros agentes de terminal.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add BladeRunnerYao/codex-voice-to-text-skill

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

O que codex-voice-to-text-skill faz?

Habilidade do Codex para ditado Whisper local no macOS com push-to-talk.

Descrição

Esta habilidade permite que você use ditado por voz local no macOS, ativado por um atalho de teclado. Ao pressionar uma tecla de sua escolha, o áudio do microfone é capturado e transcrito usando o modelo Whisper da OpenAI, e o texto resultante é colado na janela ativa. Ideal para inserir código ou comandos rapidamente sem usar as mãos.

Requisitos

  • Sistema: macOS
  • Python: 3.8 ou superior
  • Pacotes: whisper, pyaudio, keyboard

Instalação

  1. Instale o Whisper:

    pip install whisper
    
  2. Instale as dependências de áudio e teclado:

    pip install pyaudio keyboard
    
  3. Clone o repositório ou copie o script para um local acessível.

Configuração

  1. Determine a combinação de teclas que ativará o ditado (padrão: cmd+shift+d).

  2. Execute o script:

    python voice_to_text.py
    
  3. Pressione a combinação de teclas configurada para iniciar a gravação.

  4. Fale claramente e solte a tecla para parar a gravação e obter a transcrição.

  5. O texto transcrito será automaticamente colado no aplicativo ativo.

Uso com Codex

Para usar esta habilidade com o Codex CLI ou outros agentes de terminal, execute o script em segundo plano e use o atalho de teclado para inserir comandos por voz diretamente no terminal.

Personalização

Edite as variáveis no início do script voice_to_text.py para alterar:

  • HOTKEY: A combinação de teclas (padrão: cmd+shift+d)
  • MODEL: O modelo Whisper a ser usado (padrão: base)
  • DEVICE: Índice do dispositivo de entrada de áudio (padrão: None para o microfone padrão)

Solução de Problemas

  • Erro de microfone: Verifique as permissões do microfone nas Preferências do Sistema > Segurança e Privacidade > Microfone.
  • Tecla não funciona: Execute o script com sudo para permissões de teclado totais.
  • Whisper lento: Use um modelo menor, como tiny, para transcrição mais rápida.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.

Licença

MIT

Habilidades Relacionadas