Ir para o conteúdo da documentação
Keebye Docs

Instalação e permissões

Requisitos de sistema, a janela de onboarding, cada permissão que o Keebye pede, as atualizações e onde os modelos ficam guardados.

O Keebye é distribuído como um DMG assinado e notarizado para Macs com Apple Silicon. Esta página lista o que ele precisa do seu Mac e o que cada permissão faz.

Requisitos

  • macOS 11.0 ou posterior.
  • Um Mac com Apple Silicon. A versão é compilada só para arm64.
  • Espaço para o modelo de voz padrão: cerca de 670 MB em disco, baixados uma única vez.

A janela de onboarding

A janela "Welcome to Keebye" mostra cinco etapas. "Finish unlocks once the model is downloaded and both permissions are granted." A mesma janela reabre mais tarde como tela de reparo se uma permissão desaparecer, por exemplo depois de uma atualização.

  1. Baixando o modelo de voz — cerca de 670 MB, uma única vez. Isso acontece enquanto você conclui as etapas abaixo.

  2. Acesso ao microfone — pressione "Grant microphone access".

  3. Acesso de acessibilidade — pressione "Open System Settings" e ative o Keebye.

  4. Escolha a sua tecla push-to-talk — Fn / Globe, ⌘ esquerda, ⌘ direita, ⌥ esquerda ou ⌥ direita.

  5. Teste — segure a hotkey e fale no campo de teste.

Microfone

O macOS pergunta: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." O Keebye pede isso na etapa 2 do onboarding.

Acessibilidade

O acesso de acessibilidade permite que o Keebye observe a sua hotkey e cole texto em qualquer app. O Keebye consulta a permissão a cada 1,5 segundos e rearma a hotkey a cada 2 segundos depois de ela ser concedida, então você não precisa reiniciar.

Speech Recognition

Solicitada apenas quando você seleciona o motor "Native (Apple Speech)". O macOS mostra: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Até ser concedida, a pílula mostra "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Atualizações

A cada abertura de um build de release, o Keebye consulta github.com/aiescu/keebye-releases em busca de uma versão mais nova. Se existir uma, ele baixa, instala em silêncio e reinicia o app. Não há aviso nem item de menu para isso.

Onde os modelos ficam guardados

Os modelos ficam em ~/Library/Application Support/com.keebye.app/models/. Os downloads são retomáveis, verificados com SHA-256 e repetidos até cinco vezes. Só o modelo padrão é baixado automaticamente; os outros motores são baixados quando você pressiona "Download model" em Settings.

  • parakeet-v3 — cerca de 670 MB (o Settings mostra ~640 MB). O padrão.
  • parakeet-v3-fp32 — cerca de 2,55 GB (o Settings mostra ~2.4 GB).
  • canary-v2 — cerca de 1,03 GB (o Settings mostra ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — cerca de 1,28 GB, opcional, usado apenas para o polimento por LLM local.