インストールと権限
Mac と Windows の動作環境、オンボーディングウィンドウ、Keebye が求める各権限、アップデート、モデルの保存場所。
Keebye は、Apple Silicon の Mac 向けには署名と公証済みの DMG として、64-bit の Windows 10 と 11 向けにはインストーラー（.exe または .msi）として配布されます。このページでは、コンピューターに必要なものと、各権限の役割を説明します。
動作環境
- Mac：macOS 11.0 以降。
- Mac：Apple Silicon の Mac。Mac 版リリースは arm64 専用でビルドされています。
- Windows：64-bit (x64) PC 上の Windows 10 または 11。
- 既定の音声モデル用の空き容量：ディスク上で約 670 MB、ダウンロードは一度だけです。
Windows へのインストール
Keebye_<version>_x64-setup.exe を実行します。MSI パッケージでソフトウェアをインストールしている場合は .msi を使ってください。Keebye はシステムトレイで起動し、Mac と同じオンボーディングウィンドウを開きます。
オンボーディングウィンドウ
"Welcome to Keebye" ウィンドウには 5 つのステップが表示されます。"Finish unlocks once the model is downloaded and both permissions are granted."（モデルのダウンロードと 2 つの権限の許可が終わると Finish が有効になります）。Windows では 2 つの権限ステップが許可済みと表示されるため、Finish はモデルだけを待ちます。アップデート後などに権限が失われた場合は、同じウィンドウが修復用の画面として再び開きます。
音声モデルのダウンロード — 約 670 MB、一度だけ。以下のステップを進めている間に実行されます。
マイクへのアクセス — "Grant microphone access" を押します。
アクセシビリティへのアクセス — Mac では "Open System Settings" を押して Keebye をオンにします。
プッシュ・トゥ・トークキーを選ぶ — Fn / Globe、左 ⌘、右 ⌘、左 ⌥、右 ⌥（Windows で対応するキーは「Keebye をはじめる」に記載）。
試してみる — ホットキーを押しながら、テスト用のフィールドに話しかけます。
マイク
Mac では、macOS がこう尋ねます："Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text."（音声をテキストにするため、音声入力のホットキーを押している間だけマイクを使います）。Keebye はオンボーディングのステップ 2 でこれを要求します。Windows では Keebye からの確認はなく、録音が始まった時点で Windows がマイクへのアクセスを許可します。
アクセシビリティ（Mac）
Mac では、アクセシビリティへのアクセスにより、Keebye はホットキーを監視し、任意のアプリにテキストをペーストできます。Keebye は許可の状態を 1.5 秒ごとに確認し、許可されるとホットキーを 2 秒ごとに再登録するため、再起動は必要ありません。Windows では同等の権限は必要ありません。
音声認識（Mac）
Mac で "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 で新しいバージョンを確認します。見つかった場合はダウンロードし、通知なくインストールしてアプリを再起動します。確認のダイアログはなく、このためのメニュー項目もありません。アップデートの配信は現在 Mac 版のみのため、Windows では keebye.com から新しいインストーラーをダウンロードしてアップデートします。
モデルの保存場所
モデルは、Mac では ~/Library/Application Support/com.keebye.app/models/、Windows では %APPDATA%\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 による仕上げにのみ使われます。