Prejsť na obsah dokumentácie
Keebye Docs

Inštalácia a povolenia

Systémové požiadavky, okno onboardingu, jednotlivé povolenia, o ktoré Keebye žiada, aktualizácie a kde sa ukladajú modely.

Keebye sa distribuuje ako podpísaný a notarizovaný DMG pre Macy s Apple Silicon. Táto stránka zhŕňa, čo potrebuje od vášho Macu a na čo slúži každé povolenie.

Požiadavky

  • macOS 11.0 alebo novší.
  • Mac s Apple Silicon. Vydanie je zostavené len pre arm64.
  • Miesto pre predvolený model reči: približne 670 MB na disku, stiahnuté jednorazovo.

Okno onboardingu

Okno "Welcome to Keebye" zobrazuje päť krokov. "Finish unlocks once the model is downloaded and both permissions are granted." To isté okno sa neskôr znovu otvorí ako opravná obrazovka, ak niektoré povolenie zmizne, napríklad po aktualizácii.

  1. Sťahovanie modelu reči — približne 670 MB, jednorazovo. Beží, kým dokončíte kroky nižšie.

  2. Prístup k mikrofónu — stlačte "Grant microphone access".

  3. Prístup k Prístupnosti — stlačte "Open System Settings" a zapnite Keebye.

  4. Zvoľte si klávesu push-to-talk — Fn / Globe, ľavý ⌘, pravý ⌘, ľavý ⌥ alebo pravý ⌥.

  5. Vyskúšajte si to — podržte hotkey a nahovorte niečo do testovacieho poľa.

Mikrofón

macOS sa pýta: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye o toto povolenie žiada v druhom kroku onboardingu.

Prístupnosť

Prístup k Prístupnosti umožňuje Keebye sledovať váš hotkey a vkladať text do ľubovoľnej aplikácie. Keebye stav povolenia kontroluje každých 1,5 sekundy a po udelení znovu aktivuje hotkey každé 2 sekundy, takže reštart nie je potrebný.

Rozpoznávanie reči

Žiada sa oň len vtedy, keď zvolíte engine "Native (Apple Speech)". macOS zobrazí: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Kým povolenie neudelíte, pilulka ukazuje "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Aktualizácie

Pri každom spustení vydanej verzie Keebye skontroluje github.com/aiescu/keebye-releases, či existuje novšia verzia. Ak áno, stiahne ju, ticho nainštaluje a aplikáciu reštartuje. Nie je pri tom žiadna výzva ani položka v ponuke.

Kde sa ukladajú modely

Modely sú v ~/Library/Application Support/com.keebye.app/models/. Sťahovanie sa dá obnoviť, overuje sa cez SHA-256 a opakuje sa až päťkrát. Automaticky sa sťahuje len predvolený model; ostatné enginy sa stiahnu, keď v Nastaveniach stlačíte "Download model".

  • parakeet-v3 — približne 670 MB (Nastavenia uvádzajú ~640 MB). Predvolený.
  • parakeet-v3-fp32 — približne 2,55 GB (Nastavenia uvádzajú ~2.4 GB).
  • canary-v2 — približne 1,03 GB (Nastavenia uvádzajú ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — približne 1,28 GB, voliteľný, používa sa len na doladenie lokálnym LLM.