Към съдържанието на документацията
Документация на Keebye

Инсталиране и разрешения

Системни изисквания, прозорецът за първоначална настройка, всяко разрешение, което Keebye иска, обновленията и къде се съхраняват моделите.

Keebye се разпространява като подписан и нотаризиран DMG за Mac с Apple Silicon. Тази страница описва какво му е нужно от вашия Mac и какво прави всяко разрешение.

Изисквания

  • macOS 11.0 или по-нов.
  • Mac с Apple Silicon. Изданието е компилирано само за arm64.
  • Място за модела за реч по подразбиране: около 670 MB на диска, изтеглени еднократно.

Прозорецът за първоначална настройка

Прозорецът "Welcome to Keebye" показва пет стъпки. "Finish unlocks once the model is downloaded and both permissions are granted." Същият прозорец се отваря отново по-късно като средство за поправка, ако някое разрешение изчезне, например след обновление.

  1. Изтегляне на модела за реч — около 670 MB, еднократно. Това върви, докато завършвате стъпките по-долу.

  2. Достъп до микрофона — натиснете "Grant microphone access".

  3. Достъп до Accessibility — натиснете "Open System Settings" и включете Keebye.

  4. Изберете клавиша си за push-to-talk — Fn / Globe, левия ⌘, десния ⌘, левия ⌥ или десния ⌥.

  5. Опитайте — задръжте клавиша си и говорете в тестовото поле.

Микрофон

macOS пита: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye иска това в стъпка 2 от първоначалната настройка.

Accessibility (достъпност)

Достъпът до Accessibility позволява на Keebye да следи клавиша ви и да поставя текст във всяко приложение. Keebye проверява разрешението на всеки 1,5 секунди и активира отново клавиша на всеки 2 секунди, след като е дадено, така че не е нужно да рестартирате.

Speech Recognition

Иска се само когато изберете двигателя "Native (Apple Speech)". macOS показва: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Докато не бъде дадено, индикаторът показва "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Обновления

При всяко стартиране на официална компилация Keebye проверява github.com/aiescu/keebye-releases за по-нова версия. Ако има такава, я изтегля, инсталира я безшумно и рестартира приложението. Няма подкана, нито елемент в менюто за това.

Къде се съхраняват моделите

Моделите се намират в ~/Library/Application Support/com.keebye.app/models/. Изтеглянията могат да се подновяват, проверяват се със SHA-256 и се повтарят до пет пъти. Само моделът по подразбиране се изтегля автоматично; другите двигатели се изтеглят, когато натиснете "Download model" в Settings.

  • parakeet-v3 — около 670 MB (в Settings се показва ~640 MB). По подразбиране.
  • parakeet-v3-fp32 — около 2,55 GB (в Settings се показва ~2.4 GB).
  • canary-v2 — около 1,03 GB (в Settings се показва ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — около 1,28 GB, по избор, използва се само за дошлифоване с локален LLM.