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

Prejsť na obsah dokumentácie
Keebye Docs

Inštalácia a povolenia

Systémové požiadavky pre Mac a Windows, 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 a ako inštalátor (.exe alebo .msi) pre 64-bitové Windows 10 a 11. Táto stránka zhŕňa, čo potrebuje od vášho počítača a na čo slúži každé povolenie.

Požiadavky

  • Mac: macOS 11.0 alebo novší.
  • Mac: Mac s Apple Silicon. Vydanie pre Mac je zostavené len pre arm64.
  • Windows: Windows 10 alebo 11 na 64-bitovom (x64) PC.
  • Miesto pre predvolený model reči: približne 670 MB na disku, stiahnuté jednorazovo.

Inštalácia na Windows

Spustite Keebye_<version>_x64-setup.exe, alebo .msi, ak softvér inštalujete z balíkov MSI. Keebye sa potom spustí v systémovej lište a otvorí to isté okno onboardingu ako na Macu.

Okno onboardingu

Okno "Welcome to Keebye" zobrazuje päť krokov. "Finish unlocks once the model is downloaded and both permissions are granted." Na Windows sa oba kroky s povoleniami zobrazia ako udelené, takže Finish čaká len na model. 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 — na Macu stlačte "Open System Settings" a zapnite Keebye.

  4. Zvoľte si klávesu push-to-talk — Fn / Globe, ľavý ⌘, pravý ⌘, ľavý ⌥ alebo pravý ⌥ (ekvivalenty pre Windows nájdete v časti Začíname).

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

Mikrofón

Na Macu sa macOS 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. Na Windows Keebye nič nežiada; Windows udelí prístup k mikrofónu, keď sa začne nahrávanie.

Prístupnosť (Mac)

Na Macu 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ý. Windows žiadne podobné povolenie nepotrebuje.

Rozpoznávanie reči (Mac)

Na Macu sa oň žiada 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. Kanál aktualizácií zatiaľ obsahuje len verziu pre Mac, takže na Windows aktualizujete stiahnutím novšieho inštalátora z keebye.com.

Kde sa ukladajú modely

Modely sú v ~/Library/Application Support/com.keebye.app/models/ na Macu a v %APPDATA%\com.keebye.app\models\ na Windows. 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.