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

Lewati ke konten dokumentasi
Keebye Docs

Instalasi dan izin

Persyaratan sistem untuk Mac dan Windows, jendela onboarding, setiap izin yang diminta Keebye, pembaruan, dan tempat model disimpan.

Keebye dikirim sebagai DMG yang sudah ditandatangani dan dinotarisasi untuk Mac Apple Silicon, dan sebagai installer (.exe atau .msi) untuk Windows 10 dan 11 64-bit. Halaman ini mendaftar apa yang dibutuhkannya dari komputer kamu dan fungsi setiap izin.

Persyaratan

  • Mac: macOS 11.0 atau lebih baru.
  • Mac: Mac Apple Silicon. Rilis Mac dibuat hanya untuk arm64.
  • Windows: Windows 10 atau 11 di PC 64-bit (x64).
  • Ruang untuk model suara default: sekitar 670 MB di disk, diunduh sekali.

Instalasi di Windows

Jalankan Keebye_<version>_x64-setup.exe, atau .msi kalau kamu biasa menginstal software dari paket MSI. Keebye lalu berjalan di system tray dan membuka jendela onboarding yang sama seperti di Mac.

Jendela onboarding

Jendela "Welcome to Keebye" menampilkan lima langkah. "Finish unlocks once the model is downloaded and both permissions are granted." Di Windows, kedua langkah izin tampil sebagai sudah diberikan, jadi Finish hanya menunggu model. Jendela yang sama terbuka lagi nanti sebagai layar perbaikan kalau sebuah izin hilang, misalnya setelah pembaruan.

  1. Mengunduh model suara — sekitar 670 MB, sekali saja. Ini berjalan sementara kamu menyelesaikan langkah-langkah di bawah.

  2. Akses Microphone — tekan "Grant microphone access".

  3. Akses Accessibility — di Mac, tekan "Open System Settings" lalu aktifkan Keebye.

  4. Pilih tombol push-to-talk kamu — Fn / Globe, ⌘ kiri, ⌘ kanan, ⌥ kiri, atau ⌥ kanan (padanannya di Windows tercantum di Memulai).

  5. Coba — tahan hotkey kamu dan bicara ke kolom uji.

Microphone

Di Mac, macOS bertanya: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye memintanya di langkah 2 onboarding. Di Windows tidak ada prompt dari Keebye; Windows memberikan akses mikrofon saat perekaman dimulai.

Accessibility (Mac)

Di Mac, akses Accessibility memungkinkan Keebye memantau hotkey kamu dan menempelkan teks ke aplikasi mana pun. Keebye memeriksa izin ini setiap 1.5 detik dan mengaktifkan ulang hotkey setiap 2 detik setelah izin diberikan, jadi kamu tidak perlu restart. Windows tidak butuh izin yang setara.

Speech Recognition (Mac)

Di Mac, hanya diminta kalau kamu memilih engine "Native (Apple Speech)". macOS menampilkan: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Sampai izin diberikan, pill menampilkan "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Pembaruan

Setiap kali build rilis dijalankan, Keebye memeriksa github.com/aiescu/keebye-releases untuk versi yang lebih baru. Kalau ada, ia mengunduh, memasang tanpa suara, dan menjalankan ulang aplikasi. Tidak ada prompt dan tidak ada item menu untuk ini. Feed pembaruan saat ini hanya memuat build Mac, jadi di Windows kamu memperbarui dengan mengunduh installer yang lebih baru dari keebye.com.

Tempat model disimpan

Model berada di ~/Library/Application Support/com.keebye.app/models/ di Mac dan %APPDATA%\com.keebye.app\models\ di Windows. Unduhan bisa dilanjutkan, diverifikasi dengan SHA-256, dan dicoba ulang hingga lima kali. Hanya model default yang diunduh otomatis; engine lain diunduh saat kamu menekan "Download model" di Settings.

  • parakeet-v3 — sekitar 670 MB (Settings menampilkan ~640 MB). Model default.
  • parakeet-v3-fp32 — sekitar 2.55 GB (Settings menampilkan ~2.4 GB).
  • canary-v2 — sekitar 1.03 GB (Settings menampilkan ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — sekitar 1.28 GB, opsional, hanya dipakai untuk polesan LLM lokal.