Instalación y permisos

Keebye se distribuye como un DMG firmado y notarizado para Macs con Apple Silicon y como instalador (.exe o .msi) para Windows 10 y 11 de 64 bits. Esta página enumera lo que necesita de tu ordenador y qué hace cada permiso.

Requisitos

• Mac: macOS 11.0 o posterior.
• Mac: un Mac con Apple Silicon. La versión para Mac está compilada solo para arm64.
• Windows: Windows 10 u 11 en un PC de 64 bits (x64).
• Espacio para el modelo de voz por defecto: unos 670 MB en disco, descargados una sola vez.

Instalación en Windows

Ejecuta Keebye_<version>_x64-setup.exe, o el .msi si instalas software desde paquetes MSI. Keebye se inicia entonces en la bandeja del sistema y abre la misma ventana de onboarding que en un Mac.

La ventana de onboarding

La ventana "Welcome to Keebye" muestra cinco pasos. "Finish unlocks once the model is downloaded and both permissions are granted." En Windows los dos pasos de permisos aparecen como concedidos, así que Finish solo espera al modelo. La misma ventana se reabre más adelante como pantalla de reparación si falta un permiso, por ejemplo tras una actualización.

1. 1

   Descarga del modelo de voz — unos 670 MB, una sola vez. Ocurre mientras completas los pasos siguientes.

2. 2

   Acceso al micrófono — pulsa "Grant microphone access".

3. 3

   Acceso de accesibilidad — en un Mac, pulsa "Open System Settings" y activa Keebye.

4. 4

   Elige tu tecla push-to-talk — Fn / Globe, ⌘ izquierda, ⌘ derecha, ⌥ izquierda o ⌥ derecha (los equivalentes de Windows están en Primeros pasos).

5. 5

   Pruébalo — mantén pulsado tu hotkey y habla en el campo de prueba.

Micrófono

En un Mac, macOS pregunta: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye lo pide en el paso 2 del onboarding. En Windows, Keebye no muestra ningún aviso; Windows concede el acceso al micrófono cuando empieza la grabación.

Accesibilidad (Mac)

En un Mac, el acceso de accesibilidad permite a Keebye vigilar tu hotkey y pegar texto en cualquier app. Keebye comprueba el permiso cada 1,5 segundos y rearma el hotkey cada 2 segundos una vez concedido, así que no hace falta reiniciar. Windows no necesita ningún permiso equivalente.

Reconocimiento de voz (Mac)

En un Mac, se pide solo cuando seleccionas el motor "Native (Apple Speech)". macOS muestra: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Hasta que se concede, la píldora muestra "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Actualizaciones

En cada arranque de una build de release, Keebye consulta github.com/aiescu/keebye-releases por si hay una versión más reciente. Si existe, la descarga, la instala en silencio y reinicia la app. No hay ningún aviso ni ninguna opción de menú para esto. Por ahora el canal de actualizaciones solo incluye la build de Mac, así que en Windows actualizas descargando el instalador más reciente desde keebye.com.

Dónde se guardan los modelos

Los modelos viven en ~/Library/Application Support/com.keebye.app/models/ en un Mac y en %APPDATA%\com.keebye.app\models\ en Windows. Las descargas se pueden reanudar, se verifican con SHA-256 y se reintentan hasta cinco veces. Solo el modelo por defecto se descarga automáticamente; los demás motores se descargan cuando pulsas "Download model" en Settings.

• parakeet-v3 — unos 670 MB (Settings muestra ~640 MB). El modelo por defecto.
• parakeet-v3-fp32 — unos 2,55 GB (Settings muestra ~2.4 GB).
• canary-v2 — unos 1,03 GB (Settings muestra ~1 GB).
• llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — unos 1,28 GB, opcional, se usa solo para el pulido con LLM local.