Ghost Pepper – macOS용 로컬 음성-텍스트 변환 앱

• macOS에서 Control 키를 누르고 말하면 자동으로 텍스트로 변환 후 붙여넣기하는 로컬 음성 인식 앱
• 모든 음성 인식과 텍스트 정리 과정이 로컬에서만 수행되어, 클라우드 전송 없이 개인정보 보호 보장
• WhisperKit과 LLM.swift 기반으로, Hugging Face 모델을 자동 다운로드해 캐시 저장
• 스마트 정리 기능으로 불필요한 말 제거 및 자기 수정 표현 보정, 메뉴 막대 앱 형태로 백그라운드 실행
• MIT 라이선스 오픈소스로 공개되어 있으며, Apple Silicon macOS 14 이상에서 동작

개요

• Ghost Pepper는 macOS용 완전 로컬 음성-텍스트 변환 앱으로, Control 키를 누르고 말한 뒤 놓으면 자동으로 텍스트로 변환 후 붙여넣기 기능 제공
• 클라우드 API를 사용하지 않으며, 모든 데이터와 모델이 로컬에서만 처리됨
• Apple Silicon(M1 이상) 기반 macOS 14.0 이상에서 동작
• 메뉴 막대 앱 형태로 실행되며, 로그인 시 자동 실행 가능
• MIT 라이선스로 공개된 오픈소스 프로젝트

주요 기능

• Control 키를 누르고 말하기 → 키를 놓으면 자동으로 텍스트 변환 및 붙여넣기
• 로컬 실행 구조로, 음성 인식과 후처리 모델이 모두 Mac 내부에서 동작
• 스마트 정리 기능으로 불필요한 말(uh, um 등)을 제거하고 자기 수정 표현을 자동 보정
• 메뉴 막대 전용 인터페이스로 Dock 아이콘 없이 백그라운드에서 작동
• 사용자 설정 지원: 정리 프롬프트 수정, 마이크 선택, 기능 on/off 전환 가능

작동 방식

• 모든 모델은 오픈소스 기반이며, 최초 실행 시 자동 다운로드 후 로컬 캐시 저장
• 음성 인식은 WhisperKit, 텍스트 정리는 LLM.swift를 통해 수행
• 모델 파일은 Hugging Face에서 제공

• 음성 인식 모델

  • Whisper tiny.en (~75MB): 가장 빠른 영어 전용 모델
  • Whisper small.en (~466MB): 기본값, 높은 정확도의 영어 전용 모델
  • Whisper small (multilingual): 다국어 지원
  • Parakeet v3 (~1.4GB): 25개 언어 지원, FluidAudio 기반

• 텍스트 정리 모델

  • Qwen 3.5 0.8B (~535MB): 기본값, 약 1~2초 내 처리
  • Qwen 3.5 2B (~1.3GB): 빠른 처리 속도(약 4~5초)
  • Qwen 3.5 4B (~2.8GB): 최고 품질(약 5~7초)

설치 및 실행

• 앱 설치

  1. GhostPepper.dmg 다운로드
  2. DMG 열기 후 Applications 폴더로 드래그
  3. 마이크 및 손쉬운 사용 권한 허용
  4. Control 키를 누르고 말하기로 사용 시작

• 소스 빌드

  1. 저장소 클론
  2. GhostPepper.xcodeproj를 Xcode에서 열기
  3. Cmd+R로 빌드 및 실행

권한 요구

추가 정보

• 로그인 시 자동 실행이 기본 활성화되어 있으며, 설정에서 비활성화 가능
• 디스크에 로그 저장 없음 — 변환된 텍스트는 파일로 기록되지 않으며, 디버그 로그는 메모리 내에서만 유지 후 앱 종료 시 삭제

기술 구성 및 의존성

• WhisperKit: 음성 인식 엔진
• LLM.swift: 텍스트 정리용 로컬 LLM
• Hugging Face: 모델 호스팅
• Sparkle: macOS 앱 업데이트 관리

이름의 의미

• 모든 모델이 로컬에서만 실행되어 개인 데이터가 외부로 전송되지 않음
• Ghost Pepper(매운 고추) 라는 이름은 무료로 제공되는 강력한 기능을 상징

기업 및 관리형 기기 지원

• 앱은 손쉬운 사용(Accessibility) 권한이 필요하며, 일반적으로 관리자 권한이 요구됨
• MDM 환경(Jamf, Kandji, Mosaic 등) 에서는 PPPC(Privacy Preferences Policy Control) 프로파일을 통해 사전 승인 가능
  • Bundle ID: com.github.matthartman.ghostpepper
  • Team ID: BBVMGXR9AY
  • Permission: Accessibility (com.apple.security.accessibility)