Sari la conținutul documentației
Keebye Docs

Instalare și permisiuni

Cerințele de sistem, fereastra de onboarding, fiecare permisiune pe care o cere Keebye, actualizările și unde sunt păstrate modelele.

Keebye e livrat ca DMG semnat și notarizat, pentru Mac-uri cu Apple Silicon. Pagina asta enumeră ce îi trebuie de la Mac-ul tău și ce face fiecare permisiune.

Cerințe

  • macOS 11.0 sau mai nou.
  • Un Mac cu Apple Silicon. Versiunea e compilată doar pentru arm64.
  • Spațiu pentru modelul vocal implicit: aproximativ 670 MB pe disc, descărcați o singură dată.

Fereastra de onboarding

Fereastra "Welcome to Keebye" arată cinci pași. "Finish unlocks once the model is downloaded and both permissions are granted." Aceeași fereastră se redeschide mai târziu, ca ecran de reparare, dacă o permisiune dispare, de exemplu după o actualizare.

  1. Se descarcă modelul vocal — aproximativ 670 MB, o singură dată. Descărcarea merge în timp ce tu parcurgi pașii de mai jos.

  2. Acces la microfon — apasă "Grant microphone access".

  3. Acces de accesibilitate — apasă "Open System Settings" și activează Keebye.

  4. Alege tasta push-to-talk — Fn / Globe, ⌘ stânga, ⌘ dreapta, ⌥ stânga sau ⌥ dreapta.

  5. Încearcă — ține apăsat hotkey-ul și vorbește în câmpul de test.

Microfon

macOS întreabă: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye cere permisiunea la pasul 2 din onboarding.

Accesibilitate

Accesul de accesibilitate îi permite lui Keebye să urmărească hotkey-ul și să lipească text în orice aplicație. Keebye verifică permisiunea la fiecare 1,5 secunde și rearmează hotkey-ul la fiecare 2 secunde după ce e acordată, așa că nu trebuie să repornești nimic.

Speech Recognition

Cerută doar când selectezi motorul "Native (Apple Speech)". macOS afișează: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Până e acordată, pastila arată "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Actualizări

La fiecare pornire a unui build de release, Keebye se uită pe github.com/aiescu/keebye-releases după o versiune mai nouă. Dacă există una, o descarcă, o instalează în fundal și repornește aplicația. Nu există nicio confirmare și niciun element de meniu pentru asta.

Unde sunt păstrate modelele

Modelele stau în ~/Library/Application Support/com.keebye.app/models/. Descărcările pot fi reluate, sunt verificate cu SHA-256 și reîncercate de până la cinci ori. Doar modelul implicit se descarcă automat; celelalte motoare se descarcă atunci când apeși "Download model" în Settings.

  • parakeet-v3 — aproximativ 670 MB (Settings arată ~640 MB). Cel implicit.
  • parakeet-v3-fp32 — aproximativ 2,55 GB (Settings arată ~2.4 GB).
  • canary-v2 — aproximativ 1,03 GB (Settings arată ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — aproximativ 1,28 GB, opțional, folosit doar pentru șlefuirea cu LLM local.