For AI agents: full index at https://keebye.com/llms.txt

Ves al contingut de la documentació
Keebye Docs

Instal·lació i permisos

Requisits del sistema per a Mac i Windows, 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 i com un instal·lador (.exe o .msi) per a Windows 10 i 11 de 64 bits. Aquesta pàgina llista què necessita del teu ordinador i què fa cada permís.

Requisits

  • Mac: macOS 11.0 o posterior.
  • Mac: un Mac amb Apple Silicon. La versió per a Mac es compila només per a arm64.
  • Windows: Windows 10 o 11 en un PC de 64 bits (x64).
  • Espai per al model de veu per defecte: uns 670 MB al disc, baixats un sol cop.

Instal·lació a Windows

Executa Keebye_<version>_x64-setup.exe, o el .msi si instal·les programari des de paquets MSI. Després el Keebye s'inicia a la safata del sistema i obre la mateixa finestra d'onboarding que en un Mac.

La finestra d'onboarding

La finestra "Welcome to Keebye" mostra cinc passos. "Finish unlocks once the model is downloaded and both permissions are granted." A Windows, tots dos passos de permisos es mostren com a concedits, així que Finish només espera el model. 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 — en un Mac, prem "Open System Settings" i activa el Keebye.

  4. Tria la teva tecla push-to-talk — Fn / Globe, ⌘ esquerra, ⌘ dreta, ⌥ esquerra o ⌥ dreta (les equivalències de Windows són a Primers passos).

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

Micròfon

En un Mac, 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. A Windows, el Keebye no mostra cap diàleg; Windows concedeix l'accés al micròfon quan comença la gravació.

Accessibilitat (Mac)

En un Mac, 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. Windows no necessita cap permís equivalent.

Reconeixement de veu (Mac)

En un Mac, 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ò. De moment, el canal d'actualitzacions només inclou la compilació per a Mac, així que a Windows actualitzes baixant l'instal·lador més nou de keebye.com.

On es guarden els models

Els models són a ~/Library/Application Support/com.keebye.app/models/ en un Mac i a %APPDATA%\com.keebye.app\models\ a Windows. 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.