OpenMontage Kurulum Rehberi: Ücretsiz AI Video Üretimini Gerçekten Test Ettik

OpenMontage, GitHub'da yayınlanan açık kaynaklı bir "agentic" video prodüksiyon sistemi. Tek başına çalışan bir uygulama değil; Claude Code gibi bir AI kodlama asistanına bağlanıp doğal dille verdiğiniz bir prompt'tan gerçek bir video üretiyor. Bu yazıda, kurulumdan tam render'a kadar gerçekten yaşadığım süreci çıkan hatalar dahil anlatıyorum.

Detaylı açıklama istemeyen arkadaşlar claude'a repo linkini yapıştırarak bunu kurmanı ve video üretecek hale getirmeni istiyorum şeklinde yazarsa claude sizi yönlendirecektir.

Repo link: https://github.com/calesthio/OpenMontage

Ön Gereksinimler

Projeyi çalıştırmak için gerekenler: Python 3.10+, Node.js 18+ ve FFmpeg. Windows'ta make komutu doğal olarak yok, bu yüzden kurulumu manuel adımlarla yapmak gerekti.

Süreçte gerçekten eksik çıkan bağımlılık FFmpeg oldu sistemde kurulu değildi ve ilk denemede "ffmpeg: command not found" hatası aldım. FFmpeg, ses miksleme, kare çıkarma ve son montaj için zorunlu olduğundan bu adımı atlayamadım; winget üzerinden kurulumu tamamladım, ancak kurulum sonrası PATH güncellenmediği için ikili dosyanın tam yolunu kullanarak devam etmek gerekti (yeni bir terminal oturumu açmadan PATH güncellenmiyor).

Not: HyperFrames adlı ikinci render motoru için Node.js 22+ gerekiyor; benim bilgisayarımda Node 20 vardı, bu yüzden HyperFrames kullanılamadı. Asıl render motoru olan Remotion için bu bir sorun değil.

Adım Adım Kurulum

Depoyu klonlayıp resmi kurulum komutunu deneyerek başladım:

git clone https://github.com/calesthio/OpenMontage.git
cd OpenMontage
make setup

Windows Komut İstemi'nde bu şu hatayı verdi: 'make' is not recognized as an internal or external command. Bunun üzerine make setup'ın yaptığı adımları manuel çalıştırdım:

py -3 -m venv .venv
.venv\Scripts\activate
python -m pip install -r requirements.txt
cd remotion-composer
npm install
cd ..
python -m pip install piper-tts
copy .env.example .env

npm install ERR_INVALID_ARG_TYPE hatası verirse, npx --yes npm install ile değiştirmek gerekiyor — bende çıkmadı ama dokümantasyon bunu not ediyor.

Kurulum bittikten sonra proje klasöründe claude yazarak Claude Code'u açtık ve gerçek işi ona bıraktım.

Gerçek Kullanım Örneği

Verdiğim prompt şuydu:

"45 saniyelik, günlük trading'e yeni başlayanlar için risk yönetiminin önemini anlatan data-driven bir açıklayıcı video yap. Kayıp oranı istatistiklerini stat card ve bar chart ile göster, sakin ve profesyonel bir anlatıcı sesi kullan, hafif elektronik fon müziği ekle, kelime bazlı altyazı olsun. Videodaki tüm yazılar Türkçe olsun."

Sistem bunu animated-explainer pipeline'ına yönlendirdi ve kendi kendine şu araçları seçti:

• Seslendirme: Piper TTS'in yerel Türkçe modeli (tr_TR-dfki-medium) — "zero-key" kısıtı bulut TTS sağlayıcılarını (ElevenLabs, OpenAI, Google) elediği için tek seçenek buydu.
• Müzik: Pixabay Music'te anahtarsız arama yapıp "Ambient Corporate Business Background" sorgusuyla telifsiz bir parça buldu.
• Görsel şablon: "clean-professional" playbook, jenerik finans-mavisi klişesinden kaçınmak için paleti özelleştirerek.
• Render motoru: Remotion — kelime bazlı altyazı istediğimiz için (bu özellik şu an sadece Remotion'da var, HyperFrames'te yok).
• Altyazı: Önce Whisper ile otomatik transkripsiyon denendi, ama "day trader" ifadesini yanlış duyunca bu yöntemden vazgeçildi; bunun yerine script'teki kelimeler gerçek ses süresine orantılı dağıtılarak altyazı üretildi.

Web'den gerçek istatistikler arandı (SSRN akademik çalışma: Brezilya %97; SEBI 2024: Hindistan %71-93; ESMA/CFD açıklamaları: AB %74-89) ve script bunlara referans veren kaynaklarla yazıldı.

Karşılaşılan Gerçek Sorunlar ve Çözümleri

İlk render tamamlandı ama kare kare görsel kontrolde ciddi bir sorun ortaya çıktı: koyu temada yazılar görünmüyordu. Kod okunarak dört gerçek hata bulundu ve düzeltildi hepsi remotion-composer/src/ içinde:

1. HeroTitle bileşeni, renk parametrelerini hiç kabul etmiyordu title ve subtitle dışında prop almıyordu, renkler kodun içine sabit (hardcoded) yazılmıştı. Bileşene color, accentColor, backgroundColor prop'ları eklenip varsayılan değerlerle birlikte Explainer.tsx'teki çağrı noktasına bağlandı.
2. BarChart / LineChart / PieChart / KPIGrid dispatch kodu, bu dört grafik bileşenini render ederken textColor prop'unu hiç geçirmiyordu. Sonuç: koyu arka plan üstünde varsayılan koyu renkli yazı görünmez oluyordu. Dördüne de textColor eklendi.
3. ComparisonCard dispatch'i cardBackgroundColor'ı iletmiyordu; bu da tersten aynı soruna yol açıyordu (açık panel üstünde açık renkli yazı).
4. Kök sebep — props.playbook alanı: Yukarıdaki üç düzeltme bile yeterli olmuyordu, çünkü resolveTheme() fonksiyonu playbook alanı set edildiğinde kullanıcının özel tema ayarlarını (themeConfig) tamamen görmezden gelip yerleşik bir preset'e dönüyordu.

Yani renk prop'ları doğru iletilse bile tema hiç uygulanmıyordu bu kısayol kaldırılıp tema yeniden resolve edildi. Asıl çözüm buydu.

Her düzeltmeden sonra video yeniden render edilip 8 sahnenin tamamı tekrar kare kare kontrol edildi; toplamda 4 ayrı render denemesi yapıldı.

Ayrı bir oturumda, aynı akşam, "gerçek arşiv footage'ıyla borsa tarihi belgeseli" tarzında ikinci ve daha zor bir prompt da denendi. Bu, documentary-montage pipeline'ını tetikledi ve FFmpeg eksikliği burada da bloke etti; kurulum yapıldı ama oturum tamamlanmadan (PATH doğrulaması yarım kalmış şekilde) bırakıldı yani her prompt ilk seferde sorunsuz bitmiyor.

Sonuç ve Süre

Final video: final.mp4, 46 saniye, 1920×1080, toplam maliyet $0.00. Claude Code'un kendi oturum sayacına göre bu işin tamamı (research'ten onaylı render'a) 47 dakika 26 saniye sürdü bir kısmı hata bulup düzeltmeye, bir kısmı da her düzeltmeden sonraki yeniden render ve kare kontrolüne gitti.

Dürüst Sınırlamalar

Türkçe seslendirme, Piper'ın tr_TR-dfki-medium modeliyle üretiliyor zero-key yolda tek gerçek zamanlı Türkçe seçenek bu. Bu, açık kaynak/offline bir model olduğu için Google TTS veya ElevenLabs gibi ücretli bulut sağlayıcılarına kıyasla doğallık ve tonlama çeşitliliği bakımından geride kalıyor; Whisper'ın script'teki "day trader" gibi İngilizce alıntı bir ifadeyi yanlış tanıması da bunun bir yan belirtisi. Daha doğal bir seslendirme istiyorsanız .env dosyasına ücretli bir key (Google TTS veya ElevenLabs) eklemek gerekiyor.

Ayrıca süreç sorunsuz değildi: eksik bir sistem bağımlılığı (FFmpeg) ve gerçek kod hataları (dört ayrı bug) çıktı, araç güçlü ama kusursuz değil.

Kimin İçin Uygun

Claude Code'un düzelttiğini doğrulayabilen biri için OpenMontage gerçekten güçlü ve ücretsiz bir araç özellikle veri görselleştirmeli açıklayıcı videolar için. : kurulum tek komutla bitmiyor, ara sıra sistem bağımlılığı eksik çıkabiliyor ve üretilen videoda görsel hata olması ihtimaline karşı kod seviyesinde bir gözden geçirme gerekebiliyor.