설치와 권한
시스템 요구 사항, 온보딩 창, Keebye가 요청하는 각 권한, 업데이트, 모델이 저장되는 위치.
Keebye는 Apple Silicon Mac용으로 서명과 공증을 마친 DMG로 배포됩니다. 이 문서는 Mac에 필요한 것과 각 권한의 역할을 정리합니다.
요구 사항
- macOS 11.0 이상.
- Apple Silicon Mac. 릴리스는 arm64 전용으로 빌드됩니다.
- 기본 음성 모델을 위한 여유 공간: 디스크에 약 670 MB, 다운로드는 한 번뿐입니다.
온보딩 창
"Welcome to Keebye" 창에는 다섯 단계가 표시됩니다. "Finish unlocks once the model is downloaded and both permissions are granted."(모델 다운로드가 끝나고 두 권한이 모두 허용되면 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으로 검증하며 최대 다섯 번까지 다시 시도합니다. 자동으로 다운로드되는 것은 기본 모델뿐이고, 다른 엔진은 설정에서 "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 다듬기에만 쓰입니다.