Açık kaynak · MIT Ücretsiz Aktif geliştiriliyor Toplantı ve Transkripsiyon

whisper.cpp Kurulumu

Whisper modellerini C/C++ ile çalıştıran hafif motor: 4 GB ekran kartında bile turbo modeliyle 8 dakikalık Türkçe kaydı 23 saniyede yazıya döktü.

Editör testi: · sürüm 1.9.5 (b5454) 54,6 bin GitHub yıldızı Son sürüm v1.9.5 (25 gün önce)

whisper.cpp nedir?

whisper.cpp, OpenAI'nin Whisper konuşma tanıma modellerini C/C++ ile çalıştıran açık kaynak bir projedir. Ollama ve Jan'ın arkasındaki llama.cpp'yi geliştiren ekip yazar. Python ve PyTorch gerektirmez; tek bir program ve bir model dosyasıyla ses kayıtlarını Türkçe dahil 99 dilde yazıya döker, SRT ve VTT altyazı üretir.

Asıl farkı verimlilik: Modelleri sıkıştırılmış (kuantize) biçimde çalıştırabildiği için Türkçede iyi sonuç veren turbo modeli 4 GB ekran kartımızda yaklaşık 1 GB bellekle çalıştı ve 8 dakikalık kaydı 23 saniyede yazdı. Aynı kartta Python Whisper turbo modelini yükleyemedi. Ekran kartı olmayan bilgisayarlarda da Python sürümünden birkaç kat hızlıdır; Apple Silicon Mac'lerde Metal ile hızlanır.

Projeyle gelen whisper-cli dosyaları komut satırından yazıya döker, whisper-server ise tarayıcıdan dosya yükleyebileceğiniz sade bir form ve başka programların kullanabileceği bir API açar. Komut satırına alışık değilseniz, arka planda whisper.cpp kullanan masaüstü uygulamalarına da bakabilirsiniz; ama Türkçe ayarı ve model seçimi için bu sayfadaki bulgular yine geçerlidir.

Arayüz
Komut satırı
İnternet
Kurulumdan sonra internetsiz çalışır
Kurulum
Orta: Birkaç komut satırı adımı; terminal açmayı bilmek yeter.
Türkçe
Arayüz Türkçe değil. Komut satırı ve sunucu arayüzü İngilizce. Türkçe kayıtlarda -l tr yazmayı unutmayın: Varsayılan dil İngilizcedir ve small gibi modeller Türkçe kaydı yarı İngilizce yazar.
Geliştirici
ggml-org (Georgi Gerganov ve topluluk)

Artıları

  • 4 GB ekran kartında turbo modelini yaklaşık 1 GB bellekle çalıştırdı; Python Whisper aynı kartta turboyu yükleyemedi.
  • Ekran kartı olmadan da Python Whisper'dan 3,4 kat hızlı.
  • Kurulum küçük: Hazır paket 10 MB, Python ya da PyTorch gerekmez.
  • whisper-server ile tarayıcıdan dosya yükleme ve yerel API sunar.
  • Apple Silicon, NVIDIA, AMD (Vulkan) ve işlemci için ayrı hızlandırma desteği var.

Eksileri

  • Linux'ta hazır CUDA paketi yok; ekran kartı için kaynaktan derlemek gerekir.
  • Varsayılan dil İngilizce; -l tr unutulursa Türkçe kayıt karışık yazılır.
  • m4a ve WhatsApp sesli mesajı (opus) gibi biçimleri okumaz; önce ffmpeg ile wav'a çevirmek gerekir.
  • Modeli elle seçip indirmek gerekir.
  • Sunucunun web formu çok sade ve İngilizce.

Bilgisayarınız yeter mi?

Ekran kartınızı ve belleğinizi seçerek bu projenin bilgisayarınızda nasıl çalışacağını görün.

Donanımımı seç
whisper.cpp donanım gereksinimleri
DonanımDestekEn düşükÖnerilen
NVIDIA ekran kartı Windows için hazır CUDA paketi var; Linux'ta CUDA ile kaynaktan derlemek gerekir. Boş 4 GB kartımızda turbo modelinin sıkıştırılmış sürümü (q5_0) yaklaşık 1 GB bellek kullandı ve 7 dakika 56 saniyelik kaydı 23 saniyede yazdı; small modeli 20 saniyede. Tam destek 2 GB VRAM 4 GB VRAM
AMD ekran kartı Vulkan ya da ROCm desteğiyle kaynaktan derlenir; hazır AMD paketi yok. Editörlerimiz AMD'de test etmedi. Tam destek 2 GB VRAM 4 GB VRAM
Apple Silicon (M serisi) Apple Silicon birinci sınıf destekli; Homebrew paketi Metal hızlandırmasıyla gelir. Editörlerimiz Mac'te test etmedi. Tam destek 8 GB RAM 16 GB RAM
Ekran kartı yok (yalnız işlemci) Ekran kartı olmadan da çalışır. Ryzen 5 5500U'da 7 dakika 56 saniyelik kaydı small modeli 3 dakikada, turbo modeli 9 dakika 48 saniyede yazdı. Python Whisper'ın aynı işlemcideki small süresinden (10 dakika 12 saniye) 3,4 kat hızlı. Tam destek 4 GB RAM 8 GB RAM
  • Sistem belleği en az 4 GB, önerilen 8 GB
  • Disk alanı en az 1 GB
  • Hazır Linux paketi 10 MB iner, açılınca 27 MB tutar. Modeli ayrıca indirirsiniz: Türkçe için önerdiğimiz large-v3-turbo-q5_0 547 MB, small 465 MB. Linux'ta CUDA ile derlemek isterseniz CUDA araçları için ayrıca 2,3 GB gerekir.

Resmî kaynak

GitHub deposunu aç

github.com/ggml-org/whisper.cpp

Yazılımı yalnızca bu adreslerden indirin. Sitemiz dosya barındırmaz; bağlantılar doğrudan projenin kendi sayfasına gider.

Hazır derlemeleri yalnız GitHub'daki ggml-org/whisper.cpp sürümler sayfasından, model dosyalarını Hugging Face'teki ggerganov/whisper.cpp deposundan indirin.


Lisans
MIT
Son sürüm
v1.9.5
Son güncelleme
19 Ekim 2026
GitHub yıldızı
54,6 bin
YZ Lab

Tarayıcıdan kullanın

whisper.cpp bilgisayarınızda çalışırken Yerel Ses ona doğrudan bağlanır. Ses kayıtlarını ve mikrofonu whisper.cpp ile yazıya dökün; metin ve altyazı (SRT, VTT) indirin.

Yerel Ses sayfasını açın

Sayfa yalnız arayüzü sunar; verileriniz bilgisayarınızdan çıkmaz. Üyelik gerekmez.

Reklam

Kurulum: Windows, macOS ve Linux'ta

İşletim sisteminizi seçin. Adımları tamamladıkça işaretleyin; ilerlemeniz bu tarayıcıda saklanır, sayfaya döndüğünüzde kaldığınız yerden devam edersiniz.

Windows · Hazır derleme

0 / 3 adım tamamlandı

Gerekenler: Resmî belgeye göre; editörlerimiz Windows'ta test etmedi. NVIDIA kartınız varsa CUDA paketi (653 MB) ekran kartını kullanır; yoksa 9 MB'lık işlemci paketini indirin.

  1. Paketi indirip açın

    PowerShell'de bir klasör açıp NVIDIA kartı için CUDA paketini indirin ve açın. Kartınız yoksa dosya adını whisper-bin-x64.zip yapın.

    PowerShell
    mkdir $env:USERPROFILE\whisper.cpp; cd $env:USERPROFILE\whisper.cpp
    curl.exe -LO https://github.com/ggml-org/whisper.cpp/releases/download/b5454/whisper-bin-win-cuda-12.4.0-x64.zip
    Expand-Archive whisper-bin-win-cuda-12.4.0-x64.zip -DestinationPath .
  2. Modeli indirin

    Türkçe için turbo modelinin sıkıştırılmış sürümünü indirin (547 MB).

    PowerShell
    curl.exe -L -o ggml-large-v3-turbo-q5_0.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q5_0.bin
  3. Kaydı yazıya dökün

    Kaydı Türkçe olarak yazıya dökün; metin ve altyazı kaydın yanına kaydedilir.

    PowerShell
    .\Release\whisper-cli.exe -m ggml-large-v3-turbo-q5_0.bin -l tr -f kayit.mp3 -otxt -osrt

macOS · Homebrew

0 / 3 adım tamamlandı

Gerekenler: Resmî belgeye göre; editörlerimiz Mac'te test etmedi. Apple Silicon Mac'lerde Metal hızlandırması kendiliğinden açılır. Homebrew kurulu değilse brew.sh adresindeki komutla önce onu kurun.

  1. whisper.cpp'yi kurun

    Terminali açıp whisper.cpp'yi Homebrew ile kurun.

    Terminal
    brew install whisper.cpp
  2. Modeli indirin

    Türkçe için turbo modelinin sıkıştırılmış sürümünü indirin (547 MB).

    Terminal
    curl -L -o ggml-large-v3-turbo-q5_0.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q5_0.bin
  3. Kaydı yazıya dökün

    Kaydı Türkçe olarak yazıya dökün. iPhone kayıtları (m4a) için önce ffmpeg ile wav'a çevirin (Sorun giderme bölümü).

    Terminal
    whisper-cli -m ggml-large-v3-turbo-q5_0.bin -l tr -f kayit.mp3 -otxt -osrt

Linux · CUDA ile derleme

0 / 6 adım tamamlandı

Gerekenler: Bu adımları Ubuntu 24.04'te NVIDIA RTX 3050 ile test ettik; yönetici yetkisi gerekmez. git ve gcc kurulu olmalı. CUDA derleyicisini micromamba ile ev klasörüne kurduk; NVIDIA'nın CUDA Toolkit paketi kuruluysa 2. adımı atlayıp 4. adımdaki iki CUDA yolu ayarını silin (bu yolu test etmedik).

  1. Kaynak kodu indirin

    Kararlı sürümün kaynak kodunu indirin.

    Terminal
    git clone --depth 1 --branch v1.9.5 https://github.com/ggml-org/whisper.cpp.git ~/whisper.cpp
  2. CUDA derleyicisini kurun

    micromamba'yı indirip CUDA 12.8 derleyicisini ve kütüphanelerini ~/cuda-12.8 klasörüne kurun. Bizde 24 saniye sürdü, 2,3 GB yer kapladı.

    Terminal
    mkdir -p ~/cuda-12.8 && cd ~/cuda-12.8
    curl -sL https://micro.mamba.pm/api/micromamba/linux-64/latest | tar -xj bin/micromamba
    MAMBA_ROOT_PREFIX=$PWD/root ./bin/micromamba create -y -p $PWD/env -c conda-forge cuda-nvcc cuda-cudart-dev libcublas-dev cuda-version=12.8
  3. cmake'i kurun

    Derleme aracı cmake'i uv ile kurun. uv yoksa önce curl -LsSf https://astral.sh/uv/install.sh | sh ile kurup terminali yeniden açın.

    Terminal
    uv tool install cmake
  4. CUDA desteğiyle derleyin

    Derlemeyi yapılandırıp başlatın. RTX 30 serisi için yalnız 86 mimarisini derlediğimizde 8 dakika 43 saniye sürdü.

    Terminal
    cd ~/whisper.cpp
    cmake -B build -DGGML_CUDA=1 -DCMAKE_CUDA_COMPILER=$HOME/cuda-12.8/env/bin/nvcc -DCUDAToolkit_ROOT=$HOME/cuda-12.8/env -DCMAKE_CUDA_ARCHITECTURES=86 -DCMAKE_BUILD_TYPE=Release
    cmake --build build -j $(nproc) --config Release

    CMAKE_CUDA_ARCHITECTURES kartınıza göre değişir: RTX 20 serisi 75, RTX 30 serisi 86, RTX 40 serisi 89. Yazmazsanız bütün mimariler için derler ve çok daha uzun sürer.

  5. Türkçe için modeli indirin

    Projeyle gelen betikle turbo modelinin sıkıştırılmış sürümünü indirin (547 MB).

    Terminal
    sh ./models/download-ggml-model.sh large-v3-turbo-q5_0
  6. Kaydı yazıya dökün

    Kaydı Türkçe olarak yazıya dökün. Kayıtta ekran kartının kullanıldığını gösteren satırı görmelisiniz. 8 dakikalık kaydı 23 saniyede yazdı; metin ve altyazı kaydın yanına kaydedilir.

    Terminal
    ./build/bin/whisper-cli -m models/ggml-large-v3-turbo-q5_0.bin -l tr -f kayit.mp3 -otxt -osrt
    Şunu görmelisiniz
    whisper_backend_init_gpu: using CUDA0 backend
    …
    output_txt: saving output to 'kayit.mp3.txt'
    output_srt: saving output to 'kayit.mp3.srt'

Linux · Hazır derleme (işlemci)

0 / 3 adım tamamlandı

Gerekenler: Bu adımları Ubuntu 24.04'te test ettik; yönetici yetkisi ve derleme gerekmez. Hazır Linux paketi ekran kartını kullanmaz: 8 dakikalık kayıt turbo modeliyle 9 dakika 48 saniye, small ile 3 dakika sürdü.

  1. Paketi indirip açın

    Sürümler sayfasındaki hazır Linux paketini indirip açın (10 MB).

    Terminal
    mkdir -p ~/whisper.cpp && cd ~/whisper.cpp
    curl -LO https://github.com/ggml-org/whisper.cpp/releases/download/b5454/whisper-bin-ubuntu-x64.tar.gz
    tar -xzf whisper-bin-ubuntu-x64.tar.gz

    b5454, v1.9.5 sürümüyle aynı gün çıkan derlemedir; hazır paketler bu numaralı sürümlerde yayımlanıyor.

  2. Modeli indirin

    Türkçe için turbo modelinin sıkıştırılmış sürümünü Hugging Face'ten indirin (547 MB). İşlemcide daha hızlı bir taslak için dosya adındaki large-v3-turbo-q5_0 yerine small yazabilirsiniz.

    Terminal
    curl -L -o ggml-large-v3-turbo-q5_0.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-large-v3-turbo-q5_0.bin
  3. Kaydı yazıya dökün

    Kaydı Türkçe olarak yazıya dökün; metin ve altyazı kaydın yanına kaydedilir.

    Terminal
    ./whisper-bin-ubuntu-x64/whisper-cli -m ggml-large-v3-turbo-q5_0.bin -l tr -f kayit.mp3 -otxt -osrt
    Şunu görmelisiniz
    output_txt: saving output to 'kayit.mp3.txt'
    output_srt: saving output to 'kayit.mp3.srt'
Reklam

İlk çalıştırma

whisper.cpp'nin kurulum sihirbazı yoktur; programı açtığınız klasörde bir model dosyasıyla çalıştırırsınız.

  • Türkçe için ggml-large-v3-turbo-q5_0.bin modelini indirin (547 MB). Daha hızlı ama çok daha hatalı bir taslak için ggml-small.bin (465 MB) yeterli.
  • Kaydı whisper-cli -m model.bin -l tr -f kayit.mp3 -otxt -osrt ile yazıya dökün. Metin ekrana zaman damgalarıyla akar; bitince kayit.mp3.txt ve kayit.mp3.srt aynı klasöre kaydedilir.
  • -l tr yazmayı unutmayın; varsayılan dil İngilizcedir. Dili programın bulmasını isterseniz -l auto yazın.
  • whisper-cli wav, mp3, ogg ve flac okur. Telefon kayıtları (m4a) ve WhatsApp sesli mesajları (opus) için önce ffmpeg ile wav'a çevirin.
  • Tarayıcıdan kullanmak için whisper-server -m model.bin -l tr çalıştırıp http://127.0.0.1:8080 adresini açın; dosyayı seçip biçimi (Text, SRT, VTT, JSON) belirleyin.
CUDA ile derlenen whisper-cli, turbo modeliyle 8 dakikalık Türkçe kaydı 20,9 saniyede yazdı (en alttaki toplam süre; RTX 3050 4 GB).
CUDA ile derlenen whisper-cli, turbo modeliyle 8 dakikalık Türkçe kaydı 20,9 saniyede yazdı (en alttaki toplam süre; RTX 3050 4 GB).
whisper-server'ın tarayıcıda açılan dosya yükleme formu.
whisper-server'ın tarayıcıda açılan dosya yükleme formu.
Sunucunun aynı kaydı 10,8 saniyede yazdığı metin (Text biçimi, turbo modeli).
Sunucunun aynı kaydı 10,8 saniyede yazdığı metin (Text biçimi, turbo modeli).

Sorun giderme 4

Ekranda gördüğünüz hata metnine tıklayın; nedeni ve çözümü açılır.

Neden: Dil belirtilmediği için whisper.cpp kaydı İngilizce sanıyor. Turbo modeli yine Türkçe yazdı, ama small modeli aynı kaydı "Koronavirüs, or koronavirüsü" gibi yarı İngilizce yazdı.

Çözüm: Komuta -l tr ekleyin ya da dili programın bulması için -l auto yazın. Kayıtta "lang = tr" görmelisiniz.

Terminal
./whisper-cli -m ggml-large-v3-turbo-q5_0.bin -l tr -f kayit.wav -otxt

Neden: whisper-cli yalnız wav, mp3, ogg ve flac okur. iPhone ses kayıtları (m4a) ve WhatsApp sesli mesajları (opus) bu hatayı verdi.

Çözüm: Kaydı ffmpeg ile 16 kHz tek kanallı wav'a çevirip onu verin.

Terminal
ffmpeg -i kayit.m4a -ar 16000 -ac 1 -c:a pcm_s16le kayit.wav

Neden: GitHub'daki hazır Linux paketi yalnız işlemci içindir; NVIDIA kartınız olsa da kullanmaz. Program çalışır ama turbo modeli 8 dakikalık kayıtta 23 saniye yerine 9 dakika 48 saniye sürdü.

Çözüm: Ekran kartını kullanmak için Linux'ta "CUDA ile derleme" yöntemini izleyin. Doğru derlemede kayıtta "using CUDA0 backend" satırı görünür.

Terminal
./build/bin/whisper-cli -m models/ggml-large-v3-turbo-q5_0.bin -l tr -f kayit.wav 2>&1 | grep CUDA

Neden: -m ile model verilmediğinde whisper-cli yalnız İngilizce için olan base.en modelini models klasöründe arar.

Çözüm: İndirdiğiniz model dosyasının yolunu -m ile verin.

Terminal
./whisper-cli -m ggml-large-v3-turbo-q5_0.bin -l tr -f kayit.wav

Güncelleme ve kaldırma

Güncelleme

Hazır paketi kullanıyorsanız sürümler sayfasından yenisini indirip eski klasörün yerine açın; model dosyaları değişmez. Kaynaktan derlediyseniz klasörde git pull çalıştırıp derleme komutlarını yeniden verin. Homebrew ile kurduysanız brew upgrade whisper.cpp.

Kaldırma

Kurulum gerektirmez: Açtığınız klasörü ve model dosyalarını silin (ör. rm -rf ~/whisper.cpp). CUDA derleyicisini micromamba ile kurduysanız o klasörü de silin (ör. rm -rf ~/cuda-12.8). Homebrew'da brew uninstall whisper.cpp.

Disk alanı

Hazır Linux paketi 27 MB, CUDA ile derlenmiş program 165 MB tutar; CUDA araçları ayrıca 2,3 GB. Modeller: small 465 MB, large-v3-turbo-q5_0 547 MB, large-v3-turbo 1,5 GB.

Lisans ve ticari kullanım

Açık kaynak MIT Ticari kullanım serbest

OSI onaylı lisans: kodu kullanabilir, değiştirebilir ve dağıtabilirsiniz.

whisper.cpp'nin kodu MIT lisanslıdır. Kullandığı model dosyaları OpenAI'nin Whisper modellerinden dönüştürülmüştür; onlar da MIT lisanslıdır. Ticari projeler dahil ücretsiz kullanabilir, değiştirebilir ve dağıtabilirsiniz. Yazıya döktüğünüz kayıtta başkalarının sesi varsa izin almak ve kişisel verileri korumak sizin sorumluluğunuzdadır.

Bu bölüm bilgilendirme amaçlıdır, hukuki görüş değildir. Ticari bir işte kullanmadan önce yazılımın ve indirilen modelin lisans metnini okuyun.

Alternatifler

whisper.cpp hakkında sık sorulan sorular

Türkçe için hangi modeli indirmeliyim?

large-v3-turbo-q5_0. 547 MB'lık bu dosya turbo modelinin sıkıştırılmış sürümüdür; ekran kartımızda 1 GB bellekle çalıştı ve Türkçe okumada hataları seyrek yaptı. small modeli neredeyse aynı hızda ama kelimelerin yaklaşık dörtte birini yanlış yazdı. Ekran kartınız yoksa ve hız önemliyse small ile taslak alıp önemli kısımları turbo ile yeniden yazdırabilirsiniz.

Ekran kartı olmadan ne kadar sürer?

Ryzen 5 5500U'lu dizüstünde 8 dakikalık kayıt small modeliyle 3 dakika, turbo modeliyle 9 dakika 48 saniye sürdü. İş parçacığı sayısını 4'ten 6'ya çıkarmak (-t 6) turboyu yalnız 39 saniye hızlandırdı. Aynı kartta CUDA ile turbo 23 saniye sürdüğü için NVIDIA kartınız varsa derleme zahmetine değer.

Whisper ile whisper.cpp arasındaki fark nedir?

Model aynı, motor farklı. Whisper, OpenAI'nin PyTorch ile yazdığı özgün Python sürümüdür. whisper.cpp aynı modelleri C/C++ ile, sıkıştırılmış biçimde çalıştırır: Kurulumu 10 MB'tır, ekran kartı belleğini çok daha az kullanır, işlemcide ve Mac'te çok daha hızlıdır. Python'dan kullanmak ya da modeli ince ayarlamak istemiyorsanız whisper.cpp daha pratik.

Eski ya da gürültülü kayıtlarda nasıl sonuç veriyor?

Belirgin şekilde kötüleşiyor. 1933 tarihli Onuncu Yıl Nutku kaydını turbo modeli 10 saniyede yazdı; cümlelerin çoğu doğruydu ama "kahramanlığı" gibi kelimeler bozuldu ve bazı cümleler anlamsızlaştı. Gürültülü kayıtlarda --vad seçeneği (ayrı bir ses algılama modeliyle) sessiz ve müzikli kısımları atlayarak uydurma cümleleri azaltabilir.