whisper.cpp 퀵스타트 — 모델 다운로드·전사
whisper.cpp 퀵스타트 — 모델 다운로드·전사
whisper.cpp는 저장소를 클론하고 ggml 포맷 모델을 받은 뒤 CLI로 오디오를 전사하는 흐름으로 시작해요.
빠른 시작
git clone https://github.com/ggml-org/whisper.cpp.git
cd whisper.cpp
# 모델 다운로드 (예: base.en)
sh ./models/download-ggml-model.sh base.en
# 빌드
cmake -B build
cmake --build build -j --config Release
# 오디오 전사
./build/bin/whisper-cli -f samples/jfk.wav
- 한 파일로 데모를 찍고 싶다면
make base.en— model 다운로드 후samples폴더의 wav를 전사해요. - 자세한 사용법은
./build/bin/whisper-cli -h로 확인해요.
입력 포맷 주의
- CLI는 16-bit WAV만 받아요. mp3 같은 건 ffmpeg로 변환하세요.
ffmpeg -i input.mp3 -ar 16000 -ac 1 -c:a pcm_s16le output.wav
모델 선택
tiny/base/small/medium/large및.en(영어 전용)·다국어 변형을 골라 정확도·속도·메모리 트레이드오프를 조절할 수 있어요.