Ugrás a dokumentáció tartalmára
Keebye dokumentáció

Telepítés és engedélyek

Rendszerkövetelmények, az onboarding-ablak, a Keebye által kért engedélyek, a frissítések és a modellek helye.

A Keebye alá írt és notarizált DMG-ként érkezik Apple Silicon Macekre. Ez az oldal összeszedi, mit igényel a Macedtől, és mit tesz lehetővé az egyes engedélyek.

Követelmények

  • macOS 11.0 vagy újabb.
  • Apple Silicon Mac. A kiadás csak arm64-re készül.
  • Hely az alapértelmezett beszédmodellnek: körülbelül 670 MB a lemezen, egyszeri letöltéssel.

Az onboarding-ablak

A "Welcome to Keebye" ablak öt lépést mutat. "Finish unlocks once the model is downloaded and both permissions are granted." — a Finish tehát csak akkor válik aktívvá, ha a modell letöltődött, és mindkét engedély megvan. Ugyanez az ablak később javító felületként is megnyílik, ha egy engedély eltűnik, például egy frissítés után.

  1. A beszédmodell letöltése — körülbelül 670 MB, egyszer. Ez az alábbi lépések elvégzése közben fut.

  2. Mikrofon-engedély — nyomd meg a "Grant microphone access" gombot.

  3. Accessibility-engedély — nyomd meg az "Open System Settings" gombot, és kapcsold be a Keebye-t.

  4. Válaszd ki a push-to-talk billentyűt — Fn / Globe, bal ⌘, jobb ⌘, bal ⌥ vagy jobb ⌥.

  5. Próbáld ki — tartsd nyomva a hotkey-t, és beszélj a tesztmezőbe.

Mikrofon

A macOS ezt kérdezi: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." (A Keebye csak addig hallgatja a mikrofont, amíg nyomva tartod a diktálási hotkey-t, hogy a beszédedet szöveggé alakítsa.) A Keebye ezt az onboarding 2. lépésében kéri.

Accessibility

Az Accessibility-engedély teszi lehetővé, hogy a Keebye figyelje a hotkey-t, és bármelyik appba beillessze a szöveget. A Keebye 1,5 másodpercenként ellenőrzi az engedélyt, és megadás után 2 másodpercenként újraélesíti a hotkey-t, így nem kell újraindítanod semmit.

Speech Recognition

Csak akkor kéri, ha a "Native (Apple Speech)" motort választod. A macOS ezt írja: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Amíg nincs megadva, a buborék a "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition" üzenetet mutatja.

Frissítések

Kiadási build minden indításakor a Keebye megnézi a github.com/aiescu/keebye-releases oldalt, van-e újabb verzió. Ha van, letölti, csendben telepíti, és újraindítja az appot. Nincs hozzá kérdés, és nincs hozzá menüpont.

Hol tárolja a modelleket

A modellek a ~/Library/Application Support/com.keebye.app/models/ mappában vannak. A letöltések folytathatók, SHA-256-tal ellenőrzöttek, és legfeljebb ötször próbálkoznak újra. Automatikusan csak az alapértelmezett modell töltődik le; a többi motor akkor, amikor a Settingsben megnyomod a "Download model" gombot.

  • parakeet-v3 — körülbelül 670 MB (a Settings ~640 MB-ot ír). Ez az alapértelmezett.
  • parakeet-v3-fp32 — körülbelül 2,55 GB (a Settings ~2.4 GB-ot ír).
  • canary-v2 — körülbelül 1,03 GB (a Settings ~1 GB-ot ír).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — körülbelül 1,28 GB, választható, és csak a helyi LLM-es csiszoláshoz kell.