インストールと権限
動作環境、オンボーディングウィンドウ、Keebye が求める各権限、アップデート、モデルの保存場所。
Keebye は Apple Silicon の Mac 向けに、署名と公証済みの DMG として配布されます。このページでは、Mac に必要なものと、各権限の役割を説明します。
動作環境
- macOS 11.0 以降。
- Apple Silicon の Mac。リリースは arm64 専用でビルドされています。
- 既定の音声モデル用の空き容量：ディスク上で約 670 MB、ダウンロードは一度だけです。
オンボーディングウィンドウ
"Welcome to Keebye" ウィンドウには 5 つのステップが表示されます。"Finish unlocks once the model is downloaded and both permissions are granted."（モデルのダウンロードと 2 つの権限の許可が終わると Finish が有効になります）。アップデート後などに権限が失われた場合は、同じウィンドウが修復用の画面として再び開きます。
音声モデルのダウンロード — 約 670 MB、一度だけ。以下のステップを進めている間に実行されます。
マイクへのアクセス — "Grant microphone access" を押します。
アクセシビリティへのアクセス — "Open System Settings" を押して Keebye をオンにします。
プッシュ・トゥ・トークキーを選ぶ — Fn / Globe、左 ⌘、右 ⌘、左 ⌥、右 ⌥。
試してみる — ホットキーを押しながら、テスト用のフィールドに話しかけます。
マイク
macOS はこう尋ねます："Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text."（音声をテキストにするため、音声入力のホットキーを押している間だけマイクを使います）。Keebye はオンボーディングのステップ 2 でこれを要求します。
アクセシビリティ
アクセシビリティへのアクセスにより、Keebye はホットキーを監視し、任意のアプリにテキストをペーストできます。Keebye は許可の状態を 1.5 秒ごとに確認し、許可されるとホットキーを 2 秒ごとに再登録するため、再起動は必要ありません。
音声認識
"Native (Apple Speech)" エンジンを選んだときにのみ要求されます。macOS には次のように表示されます："Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac."（オンデバイスの音声認識で音声入力をテキストに変換します。音声は 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 で検証され、最大 5 回まで再試行されます。自動でダウンロードされるのは既定のモデルだけで、ほかのエンジンは設定で "Download model" を押したときにダウンロードされます。
- parakeet-v3 — 約 670 MB（設定の表示は ~640 MB）。既定のモデルです。
- parakeet-v3-fp32 — 約 2.55 GB（設定の表示は ~2.4 GB）。
- canary-v2 — 約 1.03 GB（設定の表示は ~1 GB）。
- llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — 約 1.28 GB。オプトインで、ローカル LLM による仕上げにのみ使われます。