Ves al contingut de la documentació
Keebye Docs

Instal·lació i permisos

Requisits del sistema, la finestra d'onboarding, cada permís que demana el Keebye, les actualitzacions i on es guarden els models.

El Keebye es distribueix com un DMG signat i notaritzat per a Macs amb Apple Silicon. Aquesta pàgina llista què necessita del teu Mac i què fa cada permís.

Requisits

  • macOS 11.0 o posterior.
  • Un Mac amb Apple Silicon. La versió publicada es compila només per a arm64.
  • Espai per al model de veu per defecte: uns 670 MB al disc, baixats un sol cop.

La finestra d'onboarding

La finestra "Welcome to Keebye" mostra cinc passos. "Finish unlocks once the model is downloaded and both permissions are granted." La mateixa finestra es torna a obrir més endavant com a superfície de reparació si falta un permís, per exemple després d'una actualització.

  1. Baixada del model de veu — uns 670 MB, un sol cop. Passa mentre acabes els passos següents.

  2. Accés al micròfon — prem "Grant microphone access".

  3. Accés d'accessibilitat — prem "Open System Settings" i activa el Keebye.

  4. Tria la teva tecla push-to-talk — Fn / Globe, ⌘ esquerra, ⌘ dreta, ⌥ esquerra o ⌥ dreta.

  5. Prova-ho — mantén premuda la hotkey i parla al camp de prova.

Micròfon

macOS pregunta: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." El Keebye ho demana al pas 2 de l'onboarding.

Accessibilitat

L'accés d'accessibilitat permet al Keebye vigilar la teva hotkey i enganxar text a qualsevol app. El Keebye consulta el permís cada 1,5 segons i torna a armar la hotkey cada 2 segons un cop concedit, així que no cal reiniciar.

Reconeixement de veu

Només es demana quan selecciones el motor "Native (Apple Speech)". macOS mostra: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Fins que no es concedeix, la píndola mostra "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Actualitzacions

A cada arrencada d'una compilació de producció, el Keebye consulta github.com/aiescu/keebye-releases per veure si hi ha una versió més nova. Si n'hi ha, la baixa, la instal·la en silenci i reinicia l'app. No hi ha cap diàleg ni cap element de menú per a això.

On es guarden els models

Els models són a ~/Library/Application Support/com.keebye.app/models/. Les baixades es poden reprendre, es verifiquen amb SHA-256 i es reintenten fins a cinc vegades. Només el model per defecte es baixa automàticament; els altres motors es baixen quan prems "Download model" a Settings.

  • parakeet-v3 — uns 670 MB (Settings mostra ~640 MB). El predeterminat.
  • parakeet-v3-fp32 — uns 2,55 GB (Settings mostra ~2,4 GB).
  • canary-v2 — uns 1,03 GB (Settings mostra ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — uns 1,28 GB, opcional, només es fa servir per al polit amb LLM local.