Chirp는 ParakeetV3 STT를 사용하여 완전히 로컬에서 실행되며, uv를 통해 엔드 투 엔드(end-to-end)로 관리되는 Windows 받아쓰기 앱입니다. Chirp는 Windows에서 실행 파일(.exe 등)을 실행할 수 있는 권한을 요구하지 않습니다. 사용자의 머신에서 Python을 실행할 수 있다면 Chirp를 실행할 수 있도록 설계되었습니다.
ParakeetV3는 Whisper-large-V3와 구별할 수 없는 정확도(다국어 WER 4.91 대 5.05)를 제공하지만, 17배 더 빠르며 CPU만 필요로 합니다. 반면 비슷한 정확도를 가진 Whisper 모델들은 GPU가 필요합니다.
-
Windows에서 빠르고 신뢰할 수 있는 로컬 우선(local-first) 받아쓰기 제공.
-
GPU가 필요하지 않으며 원하지도 않습니다.
-
기업 환경 친화적 - 새로운 실행 파일(.exe)이 필요하지 않습니다. Python을 실행할 수 있다면 Chirp를 실행할 수 있습니다.
-
선택적 int8 양자화(quantization)를 포함한 Parakeet TDT 0.6B v3를 통한 로컬 STT.
-
캡처 전환을 위한 글로벌 핫키(Global hotkey), 클립보드 붙여넣기 주입, 그리고 설정 가능한 단어 오버라이드(word overrides).
-
선택적인 오디오 피드백 신호 및 후처리된 텍스트를 위한 스타일 프롬프팅(style prompting).
-
기본적으로 CPU를 지원하며, 사용 가능한 경우 선택적인 GPU 프로바이더(provider) 지원.
src/chirp/main.py
— CLI 엔트리포인트(entrypoint) 및 애플리케이션 루프.
src/chirp/config_manager.py
— 설정 로딩 및 Windows 전용 경로 관리.
src/chirp/parakeet_manager.py
— Parakeet 백엔드 통합 및 프로바이더 처리.
src/chirp/setup.py
— 로컬 모델 자산을 준비하는 일회성 설정 루틴.
저장소를 사용자 폴더로 클론(Clone)하세요:
cd ~
git clone https://github.com/Whamp/chirp.git chirp-stt
cd chirp-stt
uv run python -m chirp.setup # 일회성 설정 및 모델 다운로드
(선택 사항) 편의를 위해 chirp 명령어를 PATH에 추가하세요:
이 저장소에는 단순히 chirp를 입력하는 것만으로 어디에서나 Chirp를 실행할 수 있게 해주는 chirp.bat 파일이 포함되어 있습니다. 이는 PowerShell 스크립트 대신 배치(batch) 파일을 사용하므로, 서명되지 않은 스크립트를 차단하는 기업용 시스템에서도 작동합니다. 이를 활성화하려면:
- 시스템 속성(System Properties) → **환경 변수(Environment Variables)**를 엽니다 (시작 메뉴에서 "environment" 검색) - 사용자 변수(User variables) 아래에서
Path를 선택하세요.
그리고 **Edit (편집)**을 클릭하세요 - **New (새로 만들기)**를 클릭하고 다음을 추가합니다:
%USERPROFILE%\chirp-stt
- **OK (확인)**를 클릭하여 저장한 다음, 새 터미널을 엽니다.
이제 어느 디렉토리에서든 다음과 같이 입력할 수 있습니다:
chirp
-
만약 PATH 별칭(alias)을 설정했다면:
chirp --verbose
chirp --help
-
또는 chirp-stt 디렉토리에서 직접 실행하려면:
uv run python -m chirp.main
-
상세/디버그 로깅 (Verbose/debug logging):
uv run python -m chirp.main -- --verbose
-
CLI 도움말 및 옵션:
uv run python -m chirp.main -- --help
-
config.toml에는 합리적인 기본값이 설정되어 있지만, 완전히 사용자 정의가 가능합니다.
-
config.toml은 또한 단어 오버라이드(word_overrides), 즉 'parra keet'를 'parakeet'로 바꾸는 등의 설정도 허용합니다. config.toml 예시:
primary_shortcut = "ctrl+shift"
stt_backend = "parakeet"
parakeet_model = "nemo-parakeet-tdt-0.6b-v3"
...
- 클론(cloned)한
chirp 디렉토리를 삭제하세요. - 이상입니다.