goodroot/hyprwhspr

hyprwhspr – Linux를 위한 빠르고 개인정보 보호 중심의 음성 인식 도구

개요

• 텍스트를 입력할 수 있는 모든 곳에서 말한 내용을 텍스트로 변환하는 Linux 네이티브 애플리케이션입니다. 시스템 전체 서비스로 실행되며, 받아쓰기 내용을 활성 창에 직접 붙여넣을 수 있습니다.
• 성능 중심 설계: 메모리에서 실행되는 장치 내 모델(Whisper, Cohere, Parakeet, Qwen3-ASR 등)을 사용하거나, 선택적으로 클라우드 API를 호출할 수 있습니다.
• Wayland 및 X11 데스크톱(Hyprland, Sway, KDE, GNOME 등)에서 작동하며, Waybar나 Noctalia와 같은 상태 표시줄과 통합됩니다.

주요 기능

기능	설명
즉각적이고 정확한 전사	모델을 RAM(또는 CPU용 ONNX)에 로드하여 거의 실시간 받아쓰기 구현.
오프라인 우선 / 개인정보 보호	모든 로컬 모델은 오디오를 기기 내에 유지하며, 클라우드 서비스는 선택 사항입니다.
다양한 백엔드	Cohere Transcribe, Parakeet TDT V3, Whisper, Qwen3-ASR 또는 범용 REST/WebSocket API 중 선택 가능.
GPU 효율성	CUDA (NVIDIA) 또는 Vulkan (AMD/Intel) 가속을 지원하며, GPU 메모리 사용량을 제한하거나 줄이는 옵션 제공.
CJK 지원 및 번역	Qwen3-ASR이 중국어/일본어/한국어를 처리하며, 내장 번역 기능으로 비영어 음성을 영어로 변환 가능.
실시간 시각적 피드백	데스크톱 테마(Omarchy, Noctalia 등)와 일치하는 화면 시각화 도구.
단축키 제어 및 자동 붙여넣기	기본 Super+Alt+D로 받아쓰기 전환; 결과는 자동 붙여넣기하거나 클립보드에 복사 가능.
오디오 더킹	녹음 중 다른 오디오 볼륨을 낮추는 옵션.
REST API / WebSocket	서비스를 다른 프로그램이나 Gemini, ElevenLabs와 같은 클라우드 공급자에 노출 가능.
장문 모드	받아쓰기를 일시 중지하고 재개하며 중간 결과를 저장.

설치 방법

• Arch Linux – AUR에서 설치 (hyprwhspr 또는 hyprwhspr-git).
• 기타 배포판 – 한 줄 설치 스크립트 실행: curl -fsSL https://hyprwhspr.com/install.sh | bash.
• 저장소의 스크립트를 사용한 수동 설치도 지원됩니다.

일반적인 워크플로우

1. hyprwhspr setup 실행 – 대화형 마법사가 전사 백엔드 선택, 모델 다운로드, 시각화 도구/바 통합 설정을 안내합니다.
2. 로그아웃/로그인하여 그룹 권한을 적용합니다.
3. 단축키 (Super+Alt+D)를 눌러 받아쓰기를 시작하고 자연스럽게 말합니다.
4. 단축키를 다시 눌러 중지 – 전사된 텍스트가 현재 포커스된 창에 나타나거나 자동으로 붙여넣어집니다.

명령줄 유틸리티

• hyprwhspr record – 터미널에서 받아쓰기 시작/중지.
• hyprwhspr transcribe <file> – 오디오 파일 전사.
• hyprwhspr model – 모델 다운로드, 목록 확인, 언로드 또는 리로드.
• hyprwhspr config – 설정 파일 보기 또는 편집.
• 서비스 관리 명령 (hyprwhspr systemd, hyprwhspr uninstall 등)

문서 및 도움말

• 전체 문서는 https://hyprwhspr.com/docs 참조 – 설정, 녹음 모드, 백엔드 세부 정보 및 문제 해결 포함.
• 로그는 journalctl --user -u hyprwhspr.service를 통해 확인 가능.
• 문제는 GitHub에서 제기할 수 있습니다.

라이선스

• MIT License.

결론 hyprwhspr은 Linux를 위해 활발히 유지 관리되는 진정한 오픈 소스 음성 인식 도구로, 낮은 지연 시간과 개인정보 보호를 중시하며 유연한 백엔드 선택과 데스크톱 통합 기능을 제공합니다.