TAU-HOME.COM
LOADING

오프라인 음성 인식 도구 Handy, 로컬 Whisper 기반 실시간 텍스트 변환 지원

클라우드 전송 없이 로컬에서 완전 오프라인으로 구동되는 오픈소스 STT 앱 Handy의 기능, 설치법 및 단축키 설정 가이드.

tau · 2026년 11월 12일

#speech-to-text #whisper #open-source #offline-stt #tauri

오프라인 음성 인식 도구 Handy, 로컬 Whisper 기반 실시간 텍스트 변환 지원

음성 인식(STT) 도구의 데이터 유출과 클라우드 API 호출 비용 부담을 덜어주는 오픈소스 데스크톱 애플리케이션 'Handy'가 개발자들 사이에서 주목받고 있습니다. Handy는 사용자가 말한 내용을 외부 서버로 보내지 않고 사용자 컴퓨터 내부에서 온디바이스로 변환해 활성화된 텍스트 필드에 바로 입력해 주는 도구입니다.

기사 주제별 콘셉트 일러스트: HANDY

대표 이미지: TAU HOME 편집부 제작 주제별 콘셉트 일러스트. 실제 제품 화면이 아닙니다. MIT 라이선스로 배포되는 Handy는 Tauri 기반 크로스 플랫폼 구조로 제작되어 가볍고 빠르며, 네트워크 연결이 완전히 끊긴 환경에서도 단축키 하나로 음성을 텍스트로 전환합니다.

완전 로컬 파이프라인: Silero VAD와 로컬 Whisper 모델

Handy의 핵심 작동 원리는 음성 녹음부터 전사 및 입력까지 모든 과정을 사용자 PC 안에서 처리하는 것입니다. 단축키를 길게 누르고 있거나 탭하여 녹음을 시작하면, Silero 기반 VAD(Voice Activity Detection)가 무음 구간을 자동으로 걸러냅니다. 녹음이 끝나면 로컬 엔진이 음성을 텍스트로 전사하여 현재 포커스가 위치한 프로그램에 자동으로 붙여넣습니다.

엔진 선택 폭도 넓습니다.

  • OpenAI Whisper 모델 계열: Small, Medium, Turbo, Large 모델을 시스템 자원에 맞춰 선택할 수 있으며, 기기 환경에 따라 GPU 가속을 활용해 지연 시간을 대폭 줄일 수 있습니다.
  • Parakeet V3 모델: CPU 환경에 최적화된 고성능 모델로, 자동 언어 감지 기능을 함께 제공합니다.

클라우드 구독료를 지불하지 않고도 프라이버시가 민감한 회의 녹취나 개인 메모 작성 작업을 기기 내에서 처리할 수 있습니다.

운영체제별 설치 및 CLI 원격 제어

Handy는 macOS, Windows, Linux 환경을 모두 지원하며, 패키지 매니저를 통해 손쉽게 설치할 수 있습니다.

  • macOS: Homebrew Cask를 통해 설치합니다.
    brew install --cask handy
    
  • Windows: winget 명령어를 사용합니다.
    winget install cjpais.Handy
    
  • Linux(Debian/Ubuntu): 릴리스 페이지에서 .deb 파일을 내려받은 뒤 의존성을 함께 처리하도록 APT로 설치합니다.
    sudo apt install ./Handy_*.deb
    

기본적인 데스크톱 GUI 외에도 CLI 원격 제어 플래그를 지원해 외부 자동화 파이프라인이나 스크립트와 결합할 수 있습니다. 이미 실행 중인 인스턴스를 대상으로 녹음 시작/중지를 전환하는 플래그(handy --toggle-transcription), 후처리 토글(handy --toggle-post-process), 작업 취소(handy --cancel) 플래그를 제공합니다. 시스템 시작 시 백그라운드로 실행할 때는 handy --start-hidden --no-tray 조합을 활용할 수 있습니다.

플랫폼별 주의사항과 기술적 한계

로컬 하드웨어 리소스를 직접 제어하는 도구인 만큼 운영체제별 하드웨어 및 윈도잉 시스템 제약 사항을 사전에 확인해야 합니다.

  • macOS 블루투스 헤드셋 음질 저하: 블루투스 마이크가 활성화되는 순간 macOS 오디오 드라이버가 양방향 통신 모드로 전환되면서 재생 음질이나 볼륨이 일시적으로 낮아질 수 있습니다. 오디오 출력은 헤드폰으로 유지하되 Handy 입력 마이크는 Mac 내장 마이크나 별도 외장 마이크로 지정하는 편이 안정적입니다.
  • macOS Globe(fn) 키 단축키 제약: Apple 정품 키보드(내장 키보드 및 매직 키보드)에서만 fn 단축키가 반응합니다. 서드파티 키보드는 펌웨어 수준에서 키를 자체 처리해 OS로 HID 이벤트를 전달하지 않으므로 일반 보조키(ctrl, option, cmd) 조합을 설정해야 합니다.
  • Linux Wayland 환경 텍스트 입력 도구: Wayland 디스플레이 서버에서는 보안 격리 정책으로 인해 텍스트 자동 입력을 위해 wtype 또는 dotool 같은 전용 도구를 사전에 설치해야 정상 작동합니다.

출처

Impact-Site-Verification: 9b3ebd10-6c45-44cf-a014-5b8c19b7b285