Repolode
ggml-org

ggml-org/whisper.cpp

OpenAI Whisper 음성 인식 모델을 C/C++로 포팅해 CPU와 GPU에서 빠르고 오프라인으로, 별도 의존성 없이 음성을 텍스트로 변환합니다.

대체할 수 있는 제품:Otter.aiGoogle Cloud Speech-to-Text

스타
54,500
포크
6,271
열린 이슈
353
마지막 커밋
어제

어떤 프로젝트인가요?

whisper.cpp는 OpenAI의 Whisper 자동 음성 인식 모델을 순수 C/C++로 구현한 프로젝트입니다. Python이나 무거운 런타임 의존성 없이 로컬에서 음성을 텍스트로 변환하므로 데스크톱, 모바일, 임베디드 앱에 실용적으로 통합할 수 있습니다.

Apple Silicon의 Metal과 Core ML, NVIDIA의 CUDA, AMD의 HIP/ROCm, Vulkan을 비롯해 AVX, ARM NEON, OpenBLAS, OpenVINO 및 여러 NPU 등 다양한 하드웨어 백엔드를 지원합니다. 모델은 전용 ggml 형식으로 저장하며, 메모리와 디스크 사용량을 줄일 수 있도록 정수 양자화도 지원합니다. 음성 활동 감지를 활성화하면 음성 변환 전에 무음 구간을 건너뛸 수 있습니다.

whisper-cli 도구 외에도 저장소에는 OpenAI 스타일 API를 제공하는 HTTP 서버, 실시간 마이크 스트리밍 예제, Rust, Go, Ruby, JavaScript, .NET 등의 언어 바인딩이 포함되어 있습니다. WebAssembly 빌드도 가능하며 iOS, Android, Raspberry Pi에서 실행할 수 있습니다.

핵심 기능

  • 01필수 의존성 없이 순수 C/C++로 완전히 오프라인에서 실행합니다.
  • 02Metal, Core ML, CUDA, Vulkan, HIP/ROCm, OpenVINO 백엔드로 추론을 가속합니다.
  • 03모델 크기와 메모리 사용량을 줄이는 정수 양자화를 지원합니다.
  • 04음성 구간만 처리하도록 음성 활동 감지 기능을 제공합니다.
  • 05HTTP 서버, 실시간 스트리밍, 언어 바인딩을 제공합니다.

활용 사례

  • 클라우드 API 없이 데스크톱이나 모바일 앱에 오프라인 음성-텍스트 변환 기능을 추가합니다.
  • 명령줄이나 배치 스크립트로 오디오 파일을 텍스트로 변환합니다.
  • 로컬 GPU 또는 CPU 서버에서 자체 호스팅하는 음성 변환 엔드포인트를 운영합니다.
  • Raspberry Pi 같은 임베디드 기기에 음성 명령이나 어시스턴트를 구축합니다.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/ggml-org/whisper.cpp.git
  2. 2

    프로젝트 디렉터리로 이동합니다

    cd whisper.cpp
  3. 3

    base.en 모델을 다운로드합니다

    sh ./models/download-ggml-model.sh base.en
  4. 4

    whisper-cli를 빌드하고 샘플 파일을 전사합니다

    cmake -B build && cmake --build build -j --config Release && ./build/bin/whisper-cli -f samples/jfk.wav

사용 전 알아둘 점

  • whisper-cli 예제는 16비트 WAV 파일만 지원하므로 다른 형식의 파일은 먼저 변환해야 합니다(예: ffmpeg 사용).
  • Core ML, OpenVINO, AMD NPU와 같은 일부 가속 기능을 사용하려면 추가 설정과 특정 하드웨어가 필요합니다.

토픽

자주 묻는 질문

whisper.cpp은(는) 무엇인가요?
OpenAI Whisper 음성 인식 모델을 C/C++로 포팅해 CPU와 GPU에서 빠르고 오프라인으로, 별도 의존성 없이 음성을 텍스트로 변환합니다. whisper.cpp는 OpenAI의 Whisper 자동 음성 인식 모델을 순수 C/C++로 구현한 프로젝트입니다. Python이나 무거운 런타임 의존성 없이 로컬에서 음성을 텍스트로 변환하므로 데스크톱, 모바일, 임베디드 앱에 실용적으로 통합할 수 있습니다.
whisper.cpp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
whisper.cpp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
whisper.cpp은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. whisper.cpp의 마지막 커밋은 2026년 10월 19일입니다.
whisper.cpp은(는) 어디에 사용할 수 있나요?
클라우드 API 없이 데스크톱이나 모바일 앱에 오프라인 음성-텍스트 변환 기능을 추가합니다. 명령줄이나 배치 스크립트로 오디오 파일을 텍스트로 변환합니다. 로컬 GPU 또는 CPU 서버에서 자체 호스팅하는 음성 변환 엔드포인트를 운영합니다. Raspberry Pi 같은 임베디드 기기에 음성 명령이나 어시스턴트를 구축합니다.
whisper.cpp는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/ggml-org/whisper.cpp.git 프로젝트 디렉터리로 이동합니다: cd whisper.cpp base.en 모델을 다운로드합니다: sh ./models/download-ggml-model.sh base.en whisper-cli를 빌드하고 샘플 파일을 전사합니다: cmake -B build && cmake --build build -j --config Release && ./build/bin/whisper-cli -f samples/jfk.wav
whisper.cpp은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ggml-org/whisper.cpp

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트