Vai al contenuto della documentazione
Documentazione Keebye

Installazione e permessi

Requisiti di sistema, la finestra di onboarding, ogni permesso che Keebye chiede, gli aggiornamenti e dove vengono salvati i modelli.

Keebye viene distribuito come DMG firmato e notarizzato per i Mac con Apple Silicon. Questa pagina elenca cosa gli serve dal tuo Mac e cosa fa ogni permesso.

Requisiti

  • macOS 11.0 o successivo.
  • Un Mac con Apple Silicon. La build pubblicata è solo per arm64.
  • Spazio per il modello vocale predefinito: circa 670 MB su disco, scaricati una volta sola.

La finestra di onboarding

La finestra "Welcome to Keebye" mostra cinque passaggi. "Finish unlocks once the model is downloaded and both permissions are granted." La stessa finestra si riapre più tardi come schermata di riparazione se un permesso manca, per esempio dopo un aggiornamento.

  1. Download del modello vocale — circa 670 MB, una volta sola. Avviene mentre completi i passaggi sotto.

  2. Accesso al microfono — premi "Grant microphone access".

  3. Accesso all'accessibilità — premi "Open System Settings" e attiva Keebye.

  4. Scegli il tasto push-to-talk — Fn / Globe, ⌘ sinistro, ⌘ destro, ⌥ sinistro o ⌥ destro.

  5. Provalo — tieni premuto l'hotkey e parla nel campo di prova.

Microfono

macOS chiede: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye lo richiede al passaggio 2 dell'onboarding.

Accessibilità

L'accesso all'accessibilità permette a Keebye di osservare il tuo hotkey e di incollare testo in qualsiasi app. Keebye controlla il permesso ogni 1,5 secondi e riarma l'hotkey ogni 2 secondi una volta concesso, quindi non serve riavviare.

Riconoscimento vocale

Viene chiesto solo quando selezioni il motore "Native (Apple Speech)". macOS mostra: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Finché non è concesso, la pillola mostra "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Aggiornamenti

A ogni avvio di una build di release Keebye consulta github.com/aiescu/keebye-releases per vedere se c'è una versione più recente. Se c'è, la scarica, la installa in silenzio e riavvia l'app. Non c'è nessuna richiesta né nessuna voce di menu per questo.

Dove vengono salvati i modelli

I modelli vivono in ~/Library/Application Support/com.keebye.app/models/. I download sono riprendibili, verificati con SHA-256 e ritentati fino a cinque volte. Solo il modello predefinito si scarica automaticamente; gli altri motori si scaricano quando premi "Download model" in Settings.

  • parakeet-v3 — circa 670 MB (Settings mostra ~640 MB). Il predefinito.
  • parakeet-v3-fp32 — circa 2,55 GB (Settings mostra ~2.4 GB).
  • canary-v2 — circa 1,03 GB (Settings mostra ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — circa 1,28 GB, opzionale, usato solo per la rifinitura con LLM locale.