Kısa cevap: OpenAI'nin Whisper modeli aslında bir uygulama değil — terminalden kurup çalıştırdığınız bir Python kütüphanesi, yani önce Homebrew, doğru Python sürümü, bir sanal ortam, FFmpeg ve (çoğu zaman) tek bir transkript elde etmeden önce yığınla bağımlılık hatasıyla uğraşmanız gerekiyor. Koda dokunmak istemiyorsanız, aynı cihaz üzerinde, gizli transkripsiyona ulaşmanın en hızlı yolu, Whisper'ı zaten içinde barındıran bir Mac uygulaması — Subtitle Studio gibi — kullanmaktır; bu da kurulumu tamamen atlar ve ham Whisper'da olmayan ön işleme ile düzenleme araçlarını da ekler.
"Whisper Mac'te nasıl çalıştırılır" diye aratıp da birinci adım ses dosyanızdan bahsetmeden önce altı adımlık bir rehbere düşmüşseniz, yanılmıyorsunuz. İşte bunun nedeni, insanların genelde nerede takıldığı ve kodsuz alternatif.
OpenAI Whisper Nedir (Ve Neden Bir Uygulama Değildir)
Whisper, OpenAI'nin 2022'de yayınlanan ve o zamandan beri güncellenen (large-v3, turbo) açık kaynaklı konuşma tanıma modelidir. Gerçekten çok başarılı — 90'dan fazla dilde isabetli, ücretsiz kullanılabilir ve hiçbir ses dosyası hiçbir yere yüklenmeden tamamen kendi cihazınızda çalışır. Bu yüzden bu kadar çok insan onu kendisi çalıştırmak istiyor.
openai/whisper GitHub deposu — 106 bin yıldız, ama indirme butonu, kurulum programı ya da açılabilecek bir uygulaması olmayan sadece bir kaynak kodu deposu
O sayfada neyin eksik olduğuna dikkat edin: indirme butonu, kurulum programı, uygulama simgesi. Elinize geçen şey bir Python kaynak kodu klasörü — 106.000 kişi bu depoyu yıldızlamış, ama yıldızlamak Mac'inize hiçbir şey kurmaz.
Ama bu GitHub deposu bir araştırma kod tabanı, tüketici ürünü değil. Resmi kurulum talimatları şunlara zaten aşina olduğunuzu varsayar:
- Farklı Python sürümlerini kurmak ve yönetmek
pipve sanal ortamları kullanmak- Bir şeyler bozulduğunda Python hata izini (traceback) okumak
- Bir sistem bağımlılığını (FFmpeg) modelin kendisinden ayrı olarak kurmak
Bunların hiçbiri bir makine öğrenimi araştırmacısından istenmesi mantıksız şeyler değil. Ama bu akşam bir YouTube videosuna altyazı eklemek isteyen biri için hayli fazla bir talep.
Whisper'ı Mac'te Çalıştırmanın "Resmi" Yolu, Adım Adım
Whisper ekibine haksızlık etmemek gerekirse, README iyi yazılmış. İşte "hiçbir şey kurulu değil" durumundan "ekranda bir transkript" durumuna geçmek için gerçekten gerekenler.
Adım 1: Homebrew'u kurun
Apple'ın gayri resmi paket yöneticisine henüz sahip değilseniz, ilk kurulacak şey bu:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Adım 2: Uyumlu bir Python sürümü kurun
Whisper'ın bağımlılık zinciri (numba, tiktoken, PyTorch) en yeni Python sürümlerini desteklemiyor. Bu yazının yazıldığı sırada Python 3.13 kurulumu bozuyor — 3.10, 3.11 veya 3.12'ye ihtiyacınız var:
brew install python@3.11
Adım 3: Sanal ortam oluşturun
Whisper'ın bağımlılıklarının sisteminizdeki başka şeylerle çakışmasını önlemek için önerilen yöntem izole bir ortam kullanmaktır:
python3.11 -m venv whisper-env
source whisper-env/bin/activate
Adım 4: FFmpeg'i kurun
Whisper sesi kendisi çözmez — bunun için ayrı olarak kurulması gereken FFmpeg'i çağırır:
brew install ffmpeg
Adım 5: Whisper'ı kurun
pip install -U openai-whisper
Adım 6: İlk transkripsiyonunuzu çalıştırın
whisper your-audio.mp3 --model turbo
Altı adım, üç ayrı kurulum programı, önceden bilmeniz gereken bir Python sürüm kısıtlaması — daha tek bir kelime bile yazıya dökülmedi. Ve bu, hiçbir şeyin ters gitmediği senaryo.
Herkesin Takıldığı Yerler (GitHub Ve StackOverflow'dan Gerçek Sorunlar)
"openai-whisper" kurulum sorunlarını aratın, aynı avuç içi kadar hata tekrar tekrar karşınıza çıkar. Bunlar gerçek raporlardan doğrudan alıntılanmıştır, yeniden yorumlanmamıştır.
"Whisper Python 3.13'te kullanılamaz"
Homebrew ile daha eski bir sürümü sabitlemek yerine python.org'dan en yeni Python'ı kurarsanız, kurulum hemen başarısız olur:
Getting requirements to build wheel ... error
KeyError: '__version__'
Konudaki bir yanıtın açıkça ifade ettiği gibi: "Whisper, yalnızca bağımlılık zincirinin yayınlanmış, desteklenen sürümleri kullanılarak Python 3.13'te kullanılamaz." (Kaynak: StackOverflow) Çözüm, Python sürümünüzü düşürmek ve sanal ortamınızı sıfırdan yeniden kurmaktır — Whisper'ın sürüme bu kadar duyarlı olduğunu önceden bilmiyorsanız hiç de aşikâr değildir.
ffmpeg kurulu olduğu halde "ffmpeg bulunamadı" hatası
Bu, Mac'te en yaygın Whisper hatalarından biridir ve tam olarak çözümün zaten çalışmış olması gerektiği görüntüsü verdiği için kafa karıştırıcıdır:
FileNotFoundError: [Errno 2] No such file or directory: 'ffmpeg': 'ffmpeg'
Bu vakadaki kullanıcı brew install ffmpeg komutunu başarıyla çalıştırmış, yeniden kurmuş, hatta bir Python FFmpeg sarmalayıcısı bile denemişti — asıl sorun FFmpeg'in çalıştırılabilir dosyasının Python'ın görebildiği PATH içinde olmamasıydı. (Kaynak: StackOverflow) Bir PATH sorununu teşhis etmek, önce PATH'in ne olduğunu bilmeyi gerektirir.
Mac'te CUDA yoktur — ama çoğu eğitim var sanıyor
Whisper'ın performansıyla ilgili neredeyse her rehber, NVIDIA'nın GPU çatısı olan CUDA'dan bahseder. Mac'lerde NVIDIA GPU bulunmaz. Apple Silicon bunun yerine MPS (Metal Performance Shaders) kullanır ve PyTorch'ta MPS desteğinin gerçek, belgelenmiş boşlukları vardır:
NotImplementedError: The operator 'aten::isin.Tensor_Tensor_out' is not
currently implemented for the MPS device. ... you can set the environment
variable `PYTORCH_ENABLE_MPS_FALLBACK=1` to use the CPU as a fallback for
this op.
Bu, Apple Silicon üzerinde Whisper'a yakın bir PyTorch modelinden gelen gerçek bir hata. (Kaynak: GitHub — huggingface/transformers #31408) Önerilen geçici çözüm o işlemi CPU'ya devretmek — yani sırf Mac kullandığınız için var olan bir hatayı düzeltmek adına daha yavaş işlem anlamına gelir.
Kurulum sırasında Rust derleyici hataları
Whisper, OpenAI'nin tiktoken tokenizer'ına bağımlıdır. Platformunuz için önceden derlenmiş bir wheel yoksa, pip onu kaynağından derlemeye çalışır ve bu da muhtemelen kurulu olmayan bir Rust araç zincirini gerektirir. Resmi README bunu doğrudan ele alır: kurulum No module named 'setuptools_rust' hatasıyla başarısız olursa, setuptools-rust'ı ve muhtemelen Rust geliştirme ortamının tamamını ayrıca kurmanız gerekir. Bu, sırf bir konuşmadan metne modeli çalıştırmak için bir derleyici araç zinciri kurmak demek.
"Daha Hızlı" Seçenekler Kaynaktan Derleme Gerektiriyor
PyTorch üzerinde çalışan düz Whisper, Mac'te belirgin şekilde yavaştır, bu yüzden yaygın tavsiye gerçek Apple Silicon hızı için whisper.cpp veya mlx-whisper'a geçmektir. İkisi de daha hızlıdır — ve ikisi de Python kurulumunu başka bir tür kurulumla değiştirir:
git clone https://github.com/ggerganov/whisper.cpp
cd whisper.cpp
make
./models/download-ggml-model.sh large-v3
./main -m models/ggml-large-v3.bin -f your-audio.wav
Bu, git, bir C++ derleyici araç zinciri ve model dosyalarını elle indirmek demek — tam olarak "kod yazmadan" değil. Ve doğru şekilde derlediğinizde bile işler, gerçekten hata ayıklaması zor şekillerde ters gidebilir. Uzun süredir kullanan biri, kendi derlediği bir whisper.cpp ikili dosyasıyla bir M4 Mac mini üzerinde bir grup dosyayı işlerken yaşadıklarını anlattı: M1'de "tamamen sorunsuz çalışıyor," ama M4'te birkaç saat sonra hiçbir hata, hiçbir çökme olmadan "sadece duruyor" ve çıktı üretmeyi bırakıyordu — çözüm, süreci her saat başı öldürüp yeniden başlatan bir script yazmaktı. ("Whisper çalışmaya devam ediyor, terminalde hiçbir hata yok, çökme yok... sadece artık hiç çıktı yok.") (Kaynak: Ars Technica OpenForum)
Bu bir acemi hatası değil — bu, bir script ve bir cron job ile aşılması gereken bir duvara yine de çarpan deneyimli bir kullanıcı.
"Kurulum Süreci Son Derece Kullanıcı Dostu Değil"
Whisper tabanlı bir araca karşı GitHub sorunu olarak açılan bu şikayet, geliştirici olmayanların tüm deneyimini özetliyor: "Kurulum programı son derece kullanıcı dostu değil, büyük dosyaların indirilmesini sürekli kesintiye uğratıyor, bu da eksik kurulum ve kayıp bir çalıştırılabilir dosyaya yol açıyor... Programlama becerisi olmayanlar için tek seçenek kaldırmak." (Kaynak: GitHub — meizhong986/WhisperJAV #85) Konunun kendi çözümü, yine, bir Python sürüm uyumsuzluğuydu — bir yabancı, çalışana kadar sorunu bildiren kişiye terminal komutlarını adım adım anlattı.
Çalıştığında Bile, Büyük Modeller Bellek Yetersizliğine Düşebilir
large-v3 modelinin rahat çalışabilmesi için yaklaşık 10 GB VRAM/birleşik belleğe ihtiyacı var. Temel 8 GB veya 16 GB'lık bir MacBook'ta bu, sürecin doğrudan çökmesine yetecek kadar dar bir sınır ve geçici çözüm olarak daha küçük, daha az isabetli bir modele düşmeyi zorunlu kılıyor.
Çalıştırmayı Başarsanız Bile, Tek Başına Whisper Altyazı Değildir
Diyelim ki yukarıdakilerin hepsini aştınız ve çalışan bir whisper your-video.mp4 --model large-v3 komutunuz var. Elinize geçen şey bir transkript, altyazı değil — ve video için bu farklı bir iş:
- Ön işleme yok. Whisper, ham sesinizi olduğu gibi alır. Arka planda müzik, oda yankısı veya gürültülü bir giriş varsa, model bunu görmezden gelmesi gerektiğini hiç bilmez — ve belgelendiği üzere sessizlik ve müzik anlarında belirsizliğini kabul etmek yerine metin uydurma (cümleleri tekrarlama, diyalog icat etme) eğilimindedir.
- Yaklaşık zamanlama. Whisper'ın yerleşik zaman damgaları yaklaşık en yakın saniyeye yuvarlanır — bir transkript için sorun değil, ama tam olarak birisi konuştuğu anda görünmesi gereken bir altyazı için değil.
- Satır kırma mantığı yok. Uzun, kesintisiz bloklar veya cümle ortasında garip bölünmeler ham çıktıda yaygındır ve
.srtdosyasını bir metin düzenleyicide açmak dışında bunu düzeltecek bir araç yoktur. - Çeviri yok. İkinci bir dil track'ine ihtiyacınız varsa, bu tamamen ayrı bir araç ve iş akışıdır.
- Düzenleme arayüzü yok. Her şey komut satırında gerçekleşir. Ne dalga formu, ne sürükle-ayarla, ne de geri al butonu vardır.
Başka bir deyişle, kurulum sorununu çözmek altyazı sorununu çözmez. Yine de ham bir transkripti gerçekten yayınlayacağınız bir şeye dönüştürmek için ikinci bir araca ihtiyacınız olur.
En Kolay Yol: Subtitle Studio İle Python'ı Tamamen Atlayın
Subtitle Studio aynı sınıftan bir Whisper modeli çalıştırır, ama yerel bir Mac uygulaması olarak: indirin, videonuzu sürükleyin, altyazılarınızı alın. Terminal yok, yönetilecek Python sürümü yok, hata ayıklanacak pip install yok.
Konuşmayla hizalanmış dalga formu, altyazı listesi ve video önizlemesiyle Subtitle Studio düzenleyicisi
Terminal gerektirmeyen kurulumun üzerine şunları da alırsınız:
- Apple Silicon'a özel ayarlanmış model. Transkripsiyon modeli, Metal hızlandırmasıyla özellikle M serisi çipler için optimize edilmiştir — desteklenmeyen MPS işlemleri için CPU'ya düşen genel bir PyTorch derlemesi değil.
- Transkripsiyondan önce ön işleme. Ses etkinliği algılama (VAD) ve gürültü azaltma, Whisper görmeden önce sesi temizler, böylece arka plan müziği ve oda gürültüsü daha az kaçırılan kelime ve daha az uydurulmuş metne yol açar — bu tam olarak ham Whisper'ın bilinen zayıf noktasıdır.
- Halüsinasyon filtreleme. Güven skoru ve konuşma etkinliği analizi, modelin sessizlik veya müzik sırasında uydurduğu hayalet metni doğrudan altyazı dosyanıza göndermeden yakalar ve kaldırır.
- Zorunlu hizalama (forced alignment). Transkripsiyondan sonra, zorunlu bir hizalayıcı metni kelime düzeyinde dalga formuna geri eşler ve Whisper'ın ~1 saniyeye yuvarlanmış zaman damgalarını kare düzeyinde hassas zamanlamayla değiştirir.
- NLP tabanlı segmentasyon. Ham transkript, keyfi karakter sayıları yerine doğal ifade sınırlarında düzgün okunabilir altyazı satırlarına bölünür.
- Yerleşik düzenleme. Bir altyazının zamanlamasını yeniden hizalamak için sürükleyin, çok uzun bir satırı bölün veya parçalanmış olanları birleştirin — bir metin düzenleyiciye aktarmaya gerek kalmadan.
Bir altyazı bloğunun ses dalga formuyla eşleşecek şekilde sürüklendiği Subtitle Studio yeniden hizalama aracı
- Cihaz üzerinde çeviri. Tamamlanmış altyazılarınızı, tamamen çevrimdışı, API anahtarı gerektirmeden ve kelime başına maliyet olmadan 25 dile çevirin — yerel modelin nasıl çalıştığını görmek için çevrimdışı çeviri hakkındaki derinlemesine incelememize bakın.
Dil seçici ve AI sağlayıcı seçenekleriyle Subtitle Studio çeviri paneli
Sesiniz ve videonuz Mac'inizden asla ayrılmaz — Whisper'ı kendiniz çalıştırmakla aynı gizlilik garantisi, sadece kurulum derdi olmadan.
Subtitle Studio
Tek seferlik satın alma. Mac'inizde tamamen çevrimdışı çalışır.
Whisper CLI ile Subtitle Studio — Yan Yana
| OpenAI Whisper (CLI) | Subtitle Studio | |
|---|---|---|
| Kurulum | Homebrew, Python sürüm yönetimi, sanal ortam, FFmpeg, pip install | Uygulamayı indirin, açın |
| Kod gerekliliği | Evet — terminal komutları, zaman zaman bağımlılık hata ayıklaması | Hayır |
| Apple Silicon hızlandırma | PyTorch MPS desteğine bağlı (boşluklar var) | Yerleşik, Metal ile optimize edilmiş model |
| Ses ön işleme | Yok — ham ses doğrudan modele gönderilir | Transkripsiyondan önce VAD + gürültü azaltma |
| Halüsinasyon yönetimi | Yok — ham model çıktısı | Otomatik olarak tespit edilir ve filtrelenir |
| Zaman damgası hassasiyeti | ~1 saniye çözünürlük | Kelime düzeyinde zorunlu hizalama |
| Altyazı satır kırma | Yok — manuel temizlik gerekli | Otomatik NLP tabanlı segmentasyon |
| Düzenleme araçları | Dışa aktarılan dosya üzerinde metin düzenleyici | Dalga formu tabanlı yeniden hizalama, bölme, birleştirme |
| Çeviri | Dahil değil | Yerleşik, çevrimdışı, 25 dil |
| Çıktı formatı | .txt, .srt, .vtt | .srt, .fcpxml |
| Maliyet | Ücretsiz (zamanınız) | Tek seferlik satın alma |
Sonuç
Whisper'ı bir pipeline'a entegre etmek, binlerce dosyayı toplu işlemek veya modeli kendiniz ince ayar yapmak isteyen bir geliştiriciyseniz, resmi CLI aracı doğru seçimdir — bu esneklik zaten onun tasarlanma amacıdır ve kurulum maliyeti yalnızca bir kez ödediğiniz bir bedeldir.
Sadece terminal açmadan bir video için isabetli, yayına hazır altyazılar istiyorsanız, kodsuz yol sizi daha hızlı hedefe ulaştırır: aynı temel teknoloji, ortam yönetimi derdi olmadan ve ham Whisper'ın asla içermek üzere tasarlanmadığı bir dizi altyazıya özel araç.
Subtitle Studio
Python yok, Homebrew yok, terminal yok. Sadece videonuzu sürükleyin.
Sıkça Sorulan Sorular
Mac'te Whisper çalıştırmak için Python bilmem gerekir mi?
Resmi openai-whisper paketini kullanmak için evet — Python kurmanız, bir sanal ortam yönetmeniz ve terminalden komutlar çalıştırmanız gerekecek. Koda dokunmak istemiyorsanız, Subtitle Studio gibi uygulamalar aynı sınıftan bir modeli sürükle-bırak arayüzüyle ve hiç kod yazmadan çalıştırır.
Whisper kurulumu Mac'imde neden başarısız oluyor?
En yaygın nedenler şunlardır: desteklenmeyen bir Python sürümü kullanmak (şu anda 3.13 kurulumu bozuyor; 3.10–3.12 kullanın), kurulu olsa bile FFmpeg'in sistem PATH'inde olmaması ve tiktoken bağımlılığını kaynağından derlemek için gereken bir Rust derleyicisinin eksik olması. Bunların her biri farklı, oldukça anlaşılması güç bir hata mesajı üretir.
Whisper Mac'imin GPU'sunu kullanır mı?
Evet, PyTorch'taki Apple'ın MPS (Metal Performance Shaders) arka ucu üzerinden kullanabilir, ama Whisper'ın işlemleri için MPS desteğinde belgelenmiş boşluklar var — bazı operatörler henüz uygulanmamış ve sessizce daha yavaş CPU çalıştırmasına geri düşüyor. whisper.cpp ve mlx-whisper genellikle orijinal Python paketine göre Apple Silicon'ı daha verimli kullanır, ama ikisi de kaynaktan derleme gerektirir.
openai-whisper, whisper.cpp ve mlx-whisper arasındaki fark nedir?
openai-whisper, OpenAI'nin orijinal Python paketidir — pip ile kurulumu en kolayıdır, ama PyTorch'un MPS arka ucu üzerinden çalıştığı için Apple Silicon'da daha yavaştır. whisper.cpp, Metal'i doğrudan kullanan ve önemli ölçüde daha hızlı olan bir C++ yeniden uygulamasıdır, ama depoyu klonlayıp kendiniz derlemeniz gerekir. mlx-whisper, Apple'ın kendi MLX çatısını kullanır ve genellikle M serisi çiplerde en hızlı seçenektir; benzer bir kaynaktan kurulum gerektirir. Üçünden hiçbiri ses ön işleme, altyazı düzenleme veya çeviri içermez — bunlar transkripsiyon motorlarıdır, altyazı araçları değil.
Mac'te kod yazmadan Whisper çalıştırmanın ücretsiz bir yolu var mı?
Whisper modelinin kendisi ücretsiz ve açık kaynaklıdır, ama onu herhangi bir kurulum yapmadan çalıştırmak, ham Python kütüphanesi yerine paketlenmiş bir uygulama gerektirir — birinin kurulumu, model yönetimini ve arayüzü sizin için halletmesi gerekir. Subtitle Studio tam olarak bunun için tasarlanmış bir Mac uygulamasıdır: terminal yok, yönetilecek bağımlılık yok, abonelik yerine tek seferlik satın alma.
Subtitle Studio, komut satırıyla aynı Whisper modelini mi kullanıyor?
Subtitle Studio, video içerik üreticilerinin gerçekten karşılaştığı türden karışık ses için oluşturulmuş — müzik üzerine diyalog, oda gürültüsü ve çok dilli konuşma — optimize edilmiş, ince ayarlanmış bir Whisper modeli kullanır ve bunu Apple Silicon hızlandırmasıyla birleştirir. pip install openai-whisper ile elde edeceğiniz bağımsız model yerine, tam bir pipeline'a (ön işleme, halüsinasyon filtreleme, zorunlu hizalama, NLP segmentasyonu) sarılmıştır. Bu pipeline'ın gerçek çıktıyı nasıl etkilediğine daha yakından bakmak için MacWhisper ve Subtitle Studio karşılaştırmamıza göz atın.
Subtitle Studio'yu Ücretsiz Deneyin
Tek seferlik satın alma. Abonelik yok. Mac'inizde tamamen çevrimdışı.
