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

Sari la conținutul documentației
Keebye Docs

Instalare și permisiuni

Cerințele de sistem pentru Mac și Windows, 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, și ca installer (.exe sau .msi) pentru Windows 10 și 11 pe 64 de biți. Pagina asta enumeră ce îi trebuie de la computerul tău și ce face fiecare permisiune.

Cerințe

  • Mac: macOS 11.0 sau mai nou.
  • Mac: un Mac cu Apple Silicon. Versiunea pentru Mac e compilată doar pentru arm64.
  • Windows: Windows 10 sau 11 pe un PC pe 64 de biți (x64).
  • Spațiu pentru modelul vocal implicit: aproximativ 670 MB pe disc, descărcați o singură dată.

Instalarea pe Windows

Rulează Keebye_<version>_x64-setup.exe sau .msi-ul, dacă instalezi programe din pachete MSI. Keebye pornește apoi în system tray și deschide aceeași fereastră de onboarding ca pe Mac.

Fereastra de onboarding

Fereastra "Welcome to Keebye" arată cinci pași. "Finish unlocks once the model is downloaded and both permissions are granted." Pe Windows, ambii pași de permisiuni apar ca acordați, așa că Finish așteaptă doar modelul. 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 — pe Mac, apasă "Open System Settings" și activează Keebye.

  4. Alege tasta push-to-talk — Fn / Globe, ⌘ stânga, ⌘ dreapta, ⌥ stânga sau ⌥ dreapta (echivalentele de pe Windows sunt în Primii pași).

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

Microfon

Pe Mac, 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. Pe Windows, Keebye nu afișează nicio cerere; Windows acordă accesul la microfon când începe înregistrarea.

Accesibilitate (Mac)

Pe Mac, 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. Pe Windows nu e nevoie de o permisiune echivalentă.

Speech Recognition (Mac)

Pe Mac, 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. Deocamdată, fluxul de actualizări conține doar build-ul pentru Mac, așa că pe Windows actualizezi descărcând installerul mai nou de pe keebye.com.

Unde sunt păstrate modelele

Modelele stau în ~/Library/Application Support/com.keebye.app/models/ pe Mac și în %APPDATA%\com.keebye.app\models\ pe Windows. 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.