Kurulum öncesi sorular

kamishibai kimin için?

Kendi seçtiği materyalle dil öğrenmek ve aylar, hatta yıllar boyunca ona geri dönmek isteyenler için. Kitaplardan, altyazılardan, derslerden veya konuşmalardan kelimeler seçersin; kamishibai bunlarla kartlar oluşturur. Program bir kursun yerini tutmaz: konuları ve öğrenme sırasını senin yerine belirlemez.

Tekrarları Anki yönetir. Programın temelinde aralıklı tekrar vardır: bildiğin kartlar giderek daha uzun aralıklarla, unuttukların ise daha erken karşına çıkar. Yeni kart sayısını ve günlük sınırları Anki'de ayarlarsın.

Neden manga?

Yeni nesil yapay zekâ ajanları sayesinde, eskiden blog yazdığımız kadar kolay biçimde kendi imzamızı taşıyan yazılımlar geliştirebileceğimize inanıyorum. Böylece deneyimlerimizi, başkalarının kolayca uygulayabileceği yaklaşımlar aracılığıyla paylaşabiliriz. Kamishibai bu fikri deneme yolum. Her şeyden önce, her gün kendim kullandığım ve bu deneyime dayanarak geliştirdiğim bir araç.

Mangaka, yani manga yaratıcısı, hikâyeyi, çizimleri ve karakterlerin kişiliklerini bütünlüklü bir eserde bizzat birleştirir. Bu yaklaşımı kendime yakın buluyorum. Kamishibai'nin görsel dilini de bu yüzden seçtim: bir projenin hem fikrinde hem de görünümünde kendine özgü bir bakış açısı olmasını seviyorum.

kamishibai uygulamasına ne ekleyebilirim?

Temel kullanımda, öğrenmek istediğin kelime veya ifadelerin listesini eklersin. Bunları sözlükteki biçimlerine dönüştürmen gerekmez: kamishibai girdiğin metni tanımaya çalışır ve aralarından seçmen için anlamlar önerir. Seçtiğin her anlam için bir cümle içeren ayrı bir kart oluşturulur.

Cümle uygun değilse neyin değişmesini istediğini yazıp yeniden oluşturabilirsin. Kart metinlerin zaten hazırsa bunları cards JSON biçiminde verebilirsin; aşağıda bunu açıklayan ayrı bir yanıt var.

Anki ne yapar, kamishibai ne yapar?

Kamishibai materyali hazırlar: cümleleri, açıklamaları, sesleri ve görselleri oluşturur; ardından bunları Anki'de açabileceğin bir deste olan .apkg dosyasında bir araya getirir.

Anki tekrarları düzenler: kartları gösterir, değerlendirmelerini kaydeder ve bir sonraki tekrarın tarihini belirler.

Kamishibai ayrıca kâğıt kartlar için PDF oluşturur. Ekransız çalışmak istersen dosyayı yazdırıp kartları kesebilirsin.

Programlama bilmek gerekiyor mu?

Hayır. Kurulumdan sonra kamishibai'yi terminalde, yani metin tabanlı bir arayüzü olan pencerede çalıştırırsın. Program seni adım adım yönlendirir: kelimeleri ekle, anlamları seç, kartları kontrol et ve desteni al. Bunun için kod yazman gerekmez.

Otomasyon için JSON biçiminde yanıt veren ayrı komutlar vardır. Betikler ve yapay zekâ ajanları bunları kullanabilir, ancak normal kullanımda bunlara ihtiyacın olmaz.

Kartta ne olacağına kim karar veriyor?

Kelimeleri ve anlamları sen seçersin; yapay zekâ modelleri de kamishibai'de tanımlanan kurallara göre materyali oluşturur. Bu kurallar kartın yapısını ve cümle, açıklama, ses ile görselin taşıması gereken özellikleri belirler.

Oluşturmadan önce zorluk düzeyini ve cümle türünü seçebilirsin: bildirme cümleleri, sorular, diyaloglar veya bunların karışımı. Sonucu kontrol edip değişiklik isteklerinle birlikte yeniden oluşturulmasını isteyebilirsin.

Hangi diller destekleniyor?

22 dil desteklenir: İngilizce, Çince, İspanyolca, Japonca, Fransızca, Almanca, Korece, Rusça, İtalyanca, Portekizce, Hintçe, Arapça, Türkçe, Lehçe, Ukraynaca, Endonezce, Vietnamca, Tayca, Yunanca, İbranice, Felemenkçe ve Çekçe.

Her deste için bir dil çifti seçilir: öğrenilen dil ile çeviri ve açıklamaların dili. Listedeki herhangi iki dili eşleştirebilirsin. Materyalin kalitesi, modellerin seçilen dil çiftiyle ne kadar iyi çalıştığına bağlıdır.

Başka bir dil gerekiyorsa GitHub'da bir talep aç; neler yapabileceğimize bakalım.

Başlamadan önce ne gerekiyor?

Kart oluşturmak için şunlar gerekir:

  • macOS, Linux veya Windows çalıştıran bir bilgisayar.
  • İnternet bağlantısı: metin, ses ve görseller Gemini API üzerinden oluşturulur.
  • Kendi Gemini API anahtarın. Google AI Studio'da anahtar oluştur →

Tekrarlar için Anki'yi kur →

Seçtiğin dilde görsellerin içindeki metnin yerel olarak kontrol edilmesi gerekiyorsa program, ilk görsel oluşturma sırasında optik karakter tanıma (OCR) modellerini de indirir.

kamishibai hangi sistemlerde çalışıyor?

macOS, Linux ve Windows için hazır sürümler vardır.

  • macOS ve Linux: Homebrew veya kurulum betiğiyle kurulur.
  • Windows: kurulum betiği Git Bash, MSYS veya Cygwin üzerinden çalıştırılır.

Komutları ve betiğin bağlantısını kurulum bölümünde bulabilirsin.

Maliyeti ne kadar?

Kamishibai ücretsiz ve açık kaynaklıdır. Kendi API anahtarınla yapılan Gemini istekleri için ayrıca ödeme yaparsın.

Metin, ses ve görselleriyle birlikte 100 kart için yaklaşık 15 ABD doları bütçe ayırabilirsin. Bu bir tahmindir: toplam tutar materyalin miktarına, yeniden oluşturma işlemlerine ve modellerin tarifelerine bağlıdır. Modeller programda zaten seçilmiştir; başlamak için bunları ayarlaman gerekmez.

Günde dört yeni kartla, yüz kartlık bir deste 25 gün yeter. Öğrendiğin cümleleri bundan sonra da tekrar etmen gerekir. Bu yüzden gerçekten kullanmak istediğim kelimeleri seçiyor, kartların kalitesini mümkün olan en düşük üretim maliyetinin önünde tutuyorum.

Kelimeler nereye gönderiliyor, anahtar nerede saklanıyor?

Çalışman bilgisayarında saklanır: ayarlar, oturumlar, önbellek ve tamamlanan dosyalar. Kamishibai'nin kart oluşturmak için kendi sunucusu yoktur.

Program, materyali oluşturmak ve kontrol etmek için kelimeleri, cümleleri ve incelenecek görselleri API anahtarını kullanarak Gemini'ye gönderir. Anki üzerinden eşitleme yaptığında tamamlanan deste ve medya dosyaları AnkiWeb'e de aktarılır.

Kaydedilen anahtar, sistemin parola kasasında değil, yerel bir ayar dosyasında bulunur. Bu dosyayı başkalarıyla paylaşma veya herkese açık bir depoya ekleme.

Kartlarda hata olabilir mi?

Evet, hatalar olabiliyor. Ancak deneyimime göre güncel model nesli artık oldukça tutarlı sonuçlar veriyor; ben de tamamlanan kartların kalitesi üzerinde çok çalışıyorum.

Şu anda en tutarlı sonuç seslendirmede elde ediliyor ve ses doğal konuşmaya yakın. Cümlelerin zorluğunu ayarlamada modeller daha az isabetli: seçilen düzeyi temel alsalar da bazen daha kolay veya daha zor bir cümle üretiyorlar.

En çok hata görsellerde görülüyor: yapay zekâ hâlâ bir insana üçüncü bir kol çizebiliyor. Bu yüzden uygulamada tamamlanan görselleri değerlendiren ayrı yapay zekâ modelleri var. Bir görsel kontrolden geçmezse program onu yeniden oluşturuyor.

Otomatik kontrol, tüm materyalin doğru olduğunu garanti etmez. Şüphelendiğin bir cümleyi sözlükten veya bir öğretmenle kontrol etmek, gerekirse kartı yeniden oluşturmak daha iyi olur.

Agent Ready tam olarak ne demek?

Claude Code gibi bir yapay zekâ ajanı kamishibai ile çalışabilir. Sen görevi tarif edersin, ajan da programın komutlarını kullanarak yerine getirir. Örneğin şunları isteyebilirsin:

  • Bir konuya göre veya kendi metninden kelimeler seçmesini.
  • Uygun anlamları seçip kartlar oluşturmasını.
  • Sonucu kontrol etmesini ve Anki'ye aktarmadan önce uygun olmayan kartları yeniden oluşturmasını.

Bunun için JSON CLI vardır: verileri JSON biçiminde döndüren ve terminalde karşılıklı soru cevap gerektirmeyen komutlar. Ajan arka planda üretim başlatabilir ve aynı anda birden fazla oturum yürütebilir.

Ajana llms.txt bağlantısını ver. Bu dosyada kamishibai'nin nasıl kurulacağı veya güncelleneceği ve kurulu sürümün yerleşik talimatlarına nasıl ulaşılacağı açıklanır. Ajanın kendi kullanımı ve ek kart üretimleri maliyeti artırabilir.

Kendi JSON kartlarım ne zaman işe yarar?

Hazır ifadeleri olduğu gibi korumak istediğinde; örneğin bir dersteki cümleleri veya kısa diyalogları. Kelime listesi yerine kartların içeriğini, belirli bir yapıya sahip metin dosyası olan cards JSON dosyasında verirsin.

Dosya yalnızca cümleyi değil, kartın zorunlu alanlarının tamamını içermelidir. Kendin hazırlayabilir veya bir yapay zekâ ajanından yardım alabilirsin. Dosyadaki ifadeler yeniden yazılmadan korunur. Kamishibai ses ve görselleri ekler, ardından APKG biçiminde Anki destesi ve yazdırılabilir PDF oluşturur.

Şema, zorunlu alanlar ve örnekler: cards-json.md →

Kartları telefonda tekrar edebilir miyim?

Evet. Kamishibai kartları bilgisayarda oluşturur; tekrarlarını Anki'nin mobil uygulamasında yapabilirsin.

  • Hazır .apkg dosyasını bilgisayarındaki Anki'de aç. Çift tıklama içe aktarmayı başlatmazsa Dosya → İçe aktar seçeneğini kullan.
  • Koleksiyonunu AnkiWeb üzerinden eşitle.
  • Mobil uygulamada aynı hesaba giriş yap ve kartları, görselleri ve sesleri indirmek için eşitlemeyi başlat.

Ekransız çalışmak için PDF'yi yazdırıp sayfaları keserek kartları katlayabilirsin. Kâğıt kartlarda seslendirme ve otomatik tekrar programı olmaz.

Metni, sesi ve görselleri kim oluşturuyor?

Metin, ses ve görselleri Gemini ailesinden modeller üretir. Kamishibai bu modellere talimat verir, sonucun bir bölümünü kontrol eder ve materyali kartlarda bir araya getirir.

Seslendirme bir model tarafından sentezlenir; bir seslendirme sanatçısının kaydı değildir. Çalışmaya başlamadan önce diğer içeriklerle birlikte onu da kontrol etmelisin.

Cevabı hatırlayamıyorsam ne yapmalıyım?

Cümlenin anlamını veya temel kelimeyi hatırlayamıyorsan “Tekrar”a bas. Anki kartı daha erken yeniden gösterir. Bu hem yeni bir kart hem de aylardır bildiğin bir kart için geçerlidir.

Değerlendirmeni ne kadar sıkı tutacağın, o sırada neyi çalıştığına bağlıdır. Başlangıçta anlamı ve temel kelimeleri hatırladıysam artikel veya edattaki küçük bir hatayı kabul ediyorum. Cümleler tanıdık hâle geldikçe bu ayrıntılarda da doğruluk aramaya başlıyorum.

Bir kart sürekli zor geliyorsa cümlenin kendisini kontrol et: anlatılan durum açık mı, içinde çok fazla bilinmeyen şey var mı? Bazen örneği sadeleştirmek veya değiştirmek, aynı hâliyle tekrar tekrar ezberlemeye çalışmaktan daha faydalıdır.

Ne zaman sonuç bekleyebilirim?

Kesin bir süre yok. Sonuç; başlangıç düzeyine, seçtiğin cümlelere, tekrar düzenine ve dili Anki dışında kullanıp kullanmadığına bağlıdır.

İyice öğrendiğin ilk 50 cümleyi ilerlemeni değerlendirmek için bir durak olarak görebilirsin: tanıdık ifadeleri daha kolay hatırlıyor musun, yeni metinlerde tanıyor musun, konuşurken kullanabiliyor musun? Bu sayı, aşıldığında mutlaka “dil sezgisi” kazanacağın bir eşik değil. Yalnızca kart sayısına değil, artık neleri yapabildiğine bak.

$ brew install anatoly-chichikov/tap/kamishibai