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

Przejdź do treści dokumentacji
Keebye Docs

Instalacja i uprawnienia

Wymagania systemowe na Maca i Windows, 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 oraz jako instalator (.exe lub .msi) dla 64-bitowego Windows 10 i 11. Ta strona wymienia, czego potrzebuje od Twojego komputera i do czego służy każde uprawnienie.

Wymagania

  • Mac: macOS 11.0 lub nowszy.
  • Mac: Mac z Apple Silicon. Wydanie na Maca jest zbudowane wyłącznie dla arm64.
  • Windows: Windows 10 lub 11 na 64-bitowym komputerze (x64).
  • Miejsce na domyślny model mowy: około 670 MB na dysku, pobierane raz.

Instalacja na Windows

Uruchom Keebye_<version>_x64-setup.exe albo plik .msi, jeśli instalujesz oprogramowanie z pakietów MSI. Keebye uruchomi się wtedy w zasobniku systemowym i otworzy to samo okno wdrożenia co na Macu.

Okno wdrożenia

Okno "Welcome to Keebye" pokazuje pięć kroków. "Finish unlocks once the model is downloaded and both permissions are granted." Na Windows oba kroki uprawnień są oznaczone jako nadane, więc Finish czeka tylko na model. 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 — na Macu naciśnij "Open System Settings" i włącz Keebye.

  4. Wybierz klawisz push-to-talk — Fn / Globe, lewy ⌘, prawy ⌘, lewy ⌥ lub prawy ⌥ (odpowiedniki na Windows znajdziesz w Pierwszych krokach).

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

Mikrofon

Na Macu 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. Na Windows Keebye o nic nie pyta; Windows przyznaje dostęp do mikrofonu, gdy zaczyna się nagrywanie.

Dostępność (Mac)

Na Macu 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ć. Windows nie wymaga odpowiednika tego uprawnienia.

Rozpoznawanie mowy (Mac)

Na Macu 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. Kanał aktualizacji obejmuje na razie tylko build na Maca, więc na Windows aktualizujesz aplikację, pobierając nowszy instalator z keebye.com.

Gdzie przechowywane są modele

Modele leżą w ~/Library/Application Support/com.keebye.app/models/ na Macu i w %APPDATA%\com.keebye.app\models\ na Windows. 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.