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

Vai al contenuto della documentazione
Documentazione Keebye

Installazione e permessi

Requisiti di sistema per Mac e Windows, 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 e come programma di installazione (.exe o .msi) per Windows 10 e 11 a 64 bit. Questa pagina elenca cosa gli serve dal tuo computer e cosa fa ogni permesso.

Requisiti

  • Mac: macOS 11.0 o successivo.
  • Mac: un Mac con Apple Silicon. La build per Mac è solo per arm64.
  • Windows: Windows 10 o 11 su un PC a 64 bit (x64).
  • Spazio per il modello vocale predefinito: circa 670 MB su disco, scaricati una volta sola.

Installazione su Windows

Esegui Keebye_<version>_x64-setup.exe, oppure il .msi se installi software da pacchetti MSI. Keebye si avvia poi nell'area di notifica e apre la stessa finestra di onboarding che su Mac.

La finestra di onboarding

La finestra "Welcome to Keebye" mostra cinque passaggi. "Finish unlocks once the model is downloaded and both permissions are granted." Su Windows entrambi i passaggi dei permessi risultano concessi, quindi Finish aspetta solo il modello. 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à — su Mac, premi "Open System Settings" e attiva Keebye.

  4. Scegli il tasto push-to-talk — Fn / Globe, ⌘ sinistro, ⌘ destro, ⌥ sinistro o ⌥ destro (gli equivalenti Windows sono elencati in Primi passi).

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

Microfono

Su Mac, 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. Su Windows Keebye non mostra alcuna richiesta: Windows concede l'accesso al microfono quando inizia la registrazione.

Accessibilità (Mac)

Su Mac, 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. Windows non richiede un permesso equivalente.

Riconoscimento vocale (Mac)

Su Mac, 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. Per ora il canale di aggiornamento contiene solo la build per Mac, quindi su Windows aggiorni scaricando il nuovo programma di installazione da keebye.com.

Dove vengono salvati i modelli

I modelli vivono in ~/Library/Application Support/com.keebye.app/models/ su Mac e in %APPDATA%\com.keebye.app\models\ su Windows. 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.