Przejdź do treści dokumentacji
Keebye Docs

Instalacja i uprawnienia

Wymagania systemowe, okno wdrożenia, każde uprawnienie, o które prosi Keebye, aktualizacje i miejsce przechowywania modeli.

Keebye jest dostarczany jako podpisany i notaryzowany obraz DMG dla Maców z Apple Silicon. Ta strona wymienia, czego potrzebuje od Twojego Maca i do czego służy każde uprawnienie.

Wymagania

  • macOS 11.0 lub nowszy.
  • Mac z Apple Silicon. Wydanie jest zbudowane wyłącznie dla arm64.
  • Miejsce na domyślny model mowy: około 670 MB na dysku, pobierane raz.

Okno wdrożenia

Okno "Welcome to Keebye" pokazuje pięć kroków. "Finish unlocks once the model is downloaded and both permissions are granted." To samo okno otwiera się później jako ekran naprawczy, jeśli jakieś uprawnienie zniknie, na przykład po aktualizacji.

  1. Pobieranie modelu mowy — około 670 MB, jednorazowo. Dzieje się to w tle, gdy realizujesz kroki poniżej.

  2. Dostęp do mikrofonu — naciśnij "Grant microphone access".

  3. Dostęp w Dostępności — naciśnij "Open System Settings" i włącz Keebye.

  4. Wybierz klawisz push-to-talk — Fn / Globe, lewy ⌘, prawy ⌘, lewy ⌥ lub prawy ⌥.

  5. Wypróbuj — przytrzymaj klawisz i powiedz coś do pola testowego.

Mikrofon

macOS pyta: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye prosi o to w drugim kroku wdrożenia.

Dostępność

Dostęp w Dostępności pozwala Keebye widzieć Twój klawisz i wklejać tekst do dowolnej aplikacji. Keebye sprawdza to uprawnienie co 1,5 sekundy, a po jego nadaniu uzbraja klawisz na nowo co 2 sekundy, więc nie musisz nic restartować.

Rozpoznawanie mowy

Wymagane tylko wtedy, gdy wybierzesz silnik "Native (Apple Speech)". macOS pokazuje: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Dopóki nie nadasz uprawnienia, pigułka pokazuje "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Aktualizacje

Przy każdym uruchomieniu builda wydaniowego Keebye zagląda na github.com/aiescu/keebye-releases, czy jest nowsza wersja. Jeśli jest, pobiera ją, instaluje po cichu i uruchamia aplikację ponownie. Nie ma na to monitu ani pozycji w menu.

Gdzie przechowywane są modele

Modele leżą w ~/Library/Application Support/com.keebye.app/models/. Pobieranie można wznowić, jest weryfikowane sumą SHA-256 i ponawiane do pięciu razy. Automatycznie pobiera się tylko model domyślny; pozostałe silniki pobierzesz przyciskiem "Download model" w Settings.

  • parakeet-v3 — około 670 MB (Settings pokazuje ~640 MB). Domyślny.
  • parakeet-v3-fp32 — około 2,55 GB (Settings pokazuje ~2.4 GB).
  • canary-v2 — około 1,03 GB (Settings pokazuje ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — około 1,28 GB, opcjonalny, używany tylko do szlifu lokalnym LLM.