Saltar al contenido de la documentación
Documentación de Keebye

Instalación y permisos

Requisitos del sistema, la ventana de onboarding, cada permiso que pide Keebye, las actualizaciones y dónde se guardan los modelos.

Keebye se distribuye como un DMG firmado y notarizado para Macs con Apple Silicon. Esta página enumera lo que necesita de tu Mac y qué hace cada permiso.

Requisitos

  • macOS 11.0 o posterior.
  • Un Mac con Apple Silicon. La versión publicada está compilada solo para arm64.
  • Espacio para el modelo de voz por defecto: unos 670 MB en disco, descargados una sola vez.

La ventana de onboarding

La ventana "Welcome to Keebye" muestra cinco pasos. "Finish unlocks once the model is downloaded and both permissions are granted." La misma ventana se reabre más adelante como pantalla de reparación si falta un permiso, por ejemplo tras una actualización.

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

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

  3. Acceso de accesibilidad — pulsa "Open System Settings" y activa Keebye.

  4. Elige tu tecla push-to-talk — Fn / Globe, ⌘ izquierda, ⌘ derecha, ⌥ izquierda o ⌥ derecha.

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

Micrófono

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.

Accesibilidad

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.

Reconocimiento de voz

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.

Dónde se guardan los modelos

Los modelos viven en ~/Library/Application Support/com.keebye.app/models/. 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.