Ürün hazır, fiyat belli, reklam metinleri yazıldı. Ama aklınızda tek soru var: insanlar bunu sevecek mi, yoksa kaydırıp geçecek mi? Klasik yol lansmanı yapıp beklemek, yani cevabı parayı harcadıktan sonra almak.
MiroFish adlı açık kaynak bir araç bu soruyu lansmandan önce sormanızı sağlıyor. Ona bir belge veriyorsunuz, o belgeden yapay zeka ile çalışan sanal insanlar üretiyor, bu insanlar sanal bir sosyal medyada paylaşıyor, beğeniyor, tartışıyor ya da görmezden geliyor. Sonunda size ne olduğunu anlatan bir rapor çıkarıyor ve isterseniz bu sanal insanların her biriyle tek tek konuşabiliyorsunuz.
Bu yazıda MiroFish’i terminal açmadan nasıl kuracağınızı ve lansman sayfanızı, fiyatınızı, reklamlarınızı nasıl test ettireceğinizi anlatıyorum.
MiroFish nedir?
Bunu dijital bir odak grubu gibi düşünün: odadaki kişileri yapay zeka canlandırıyor ve her birinin kendi kişiliği, geçmişi ve hafızası oluyor.
- Adres: https://github.com/666ghj/MiroFish
- Lisans: AGPL-3.0, ücretsiz ve açık kaynak.
- Kendi bilgisayarınızda çalışıyor, tarayıcıdan kullanıyorsunuz.
- Çalışma sırası: belgeyi okuyup bir bilgi haritası çıkarıyor, sanal kişileri üretiyor, bu kişileri X (Twitter) benzeri ve Reddit benzeri iki sanal platformda konuşturuyor, rapor yazıyor, sonra sizi bu dünyayla sohbete bırakıyor.
Videoda “73 bin kişi kullanıyor” dedim. Doğrusu şu: 6 Ekim 2026 itibarıyla projenin GitHub’da yaklaşık 76,6 bin yıldızı var. Yıldız, projeyi beğenip kaydeden kişi sayısı, kullanıcı sayısı değil.
Bir şeyi baştan söyleyeyim: “lansman testi” MiroFish’in hazır bir düğmesi değil. Araç genel amaçlı bir tahmin motoru. Lansman testini, ona doğru belgeyi ve doğru soruyu vererek siz kuruyorsunuz. Aşağıda bunu hazır mesajlarla gösteriyorum.
Ne gerekiyor?
- Claude masaüstü uygulaması (claude.com/download) ve ücretli bir Claude planı, çünkü kurulumu Code sekmesinde yapacağız.
- Bir yapay zeka API anahtarı. MiroFish, OpenAI formatını destekleyen her sağlayıcıyla çalışıyor. Simülasyonlar çok token harcadığı için maliyet sizin hesabınıza yazılıyor. Seçenekler:
| Sağlayıcı ve model | 1 milyon token fiyatı (giriş / çıkış) | Not |
|---|---|---|
| Alibaba Cloud, qwen-flash | 0,03 $ / 0,13 $ | En ucuzu |
| Alibaba Cloud, qwen-plus | 0,40 $ / 1,20 $ | MiroFish’in kendi önerisi |
| DeepSeek, deepseek-flash | 0,15 $ / 0,60 $ (yoğun saat dışında) | Hesap açması kolay |
Alibaba Cloud yeni hesaplara Singapur bölgesinde model başına 1 milyon ücretsiz token veriyor (90 gün geçerli). Anahtarı Alibaba Cloud Model Studio konsolundan ya da platform.deepseek.com adresinden alırsınız.
- Zep Cloud anahtarı (https://app.getzep.com). Sanal kişilerin hafızasını tutan servis. Ücretsiz planda ayda 10.000 kredi var, MiroFish’in kendi notuna göre basit kullanım için yetiyor.
Node.js, Python ya da Docker gibi teknik parçaları kurmayı Claude üstleniyor.
Kurulum: linki yapıştır, “bunu kur” de
- Claude masaüstü uygulamasını açın ve Code sekmesine geçin.
- Masaüstünüzde boş bir klasör açın (örneğin mirofish) ve yeni oturumda bu klasörü seçin.
- Şu mesajı yapıştırın:
https://github.com/666ghj/MiroFish
Bunu bu klasöre kur. Ben kod bilmiyorum, terminal kullanmayacağım; bütün komutları sen çalıştır, izin gerekirse bana sor ve her adımı tek cümleyle Türkçe anlat.
README'deki yöntemi izle: Docker Desktop kuruluysa Docker ile, değilse kaynak koddan kur.
API sağlayıcı olarak [DeepSeek / Alibaba Cloud] kullanacağım. .env dosyasını oluştur, LLM_BASE_URL ve LLM_MODEL_NAME değerlerini bu sağlayıcının resmi dokümanından bulup sen yaz.
Anahtarları sohbete yazmayacağım: .env dosyasını metin düzenleyicide aç, ben LLM_API_KEY ve ZEP_API_KEY satırlarına kendim yapıştırıp kaydedeceğim.
Sonra uygulamayı başlat ve tarayıcıda http://localhost:3000 adresini aç.- Claude .env dosyasını açınca anahtarlarınızı ilgili satırlara yapıştırın, dosyayı kaydedin ve Claude’a “kaydettim, devam et” yazın.
- Tarayıcıda MiroFish açılınca dil seçiciden English‘i seçin. Arayüz varsayılan olarak Çince açılıyor, Türkçe seçeneği yok.
Kısa bir ara: araç değil, düşünme biçimi
MiroFish size bir rapor veriyor ama o raporu doğru okumak, doğru soruyu sormak ve sonucu ürününüze yansıtmak sizin işiniz. Yapay zekayı fikir testinden pazarlamaya kadar işinizin her adımında kullanmayı sıfırdan ve sırayla öğrenmek isterseniz kursuma bekliyorum, tek ödeme, ömür boyu erişim: https://dijitalburak.com/yapay-zeka-egitimi/
İlk kullanım: lansman testini kurmak
1. Lansman paketini tek belgede toplatın. MiroFish sanal kişileri belgedeki karakterlerden üretiyor. Bu yüzden belgeye ürününüz kadar hedef müşterilerinizi de yazın. Aynı Code oturumuna:
Bu klasörde lansman-paketi.md adında bir dosya hazırla. İçinde şunlar olsun:
1) Lansman sayfamın metni (aşağıya yapıştırıyorum)
2) Fiyatım ve paket seçeneklerim
3) Yayınlayacağım 3 reklam metni
4) Hedef müşterilerimi anlatan 6 farklı profil: yaş, meslek, bütçe, alışkanlık, bu ürüne neden ihtiyaç duyar ya da duymaz.
Rakiplerimi ve piyasa fiyatlarını da kısa bir bölüm olarak ekle.
[lansman sayfası metnini, fiyatı ve reklamları buraya yapıştırın]2. Simülasyonu başlatın. MiroFish ekranında 01 / Reality Seed alanına lansman-paketi.md dosyasını sürükleyin (PDF, MD ve TXT kabul ediyor). 02 / Simulation Prompt alanına şunu yazın ve Start Engine‘e basın:
Bu ürün yarın sosyal medyada lansman yapıyor. Hedef kitle lansman sayfasını, fiyatı ve 3 reklamı görüyor. Kimler ilgilenir, kimler görmezden gelir, kimler fiyatı pahalı bulur, hangi reklam en çok konuşulur ve en sık hangi itirazlar çıkar? Satın alma niyetini segment segment tahmin et.3. Adımları ilerletin. Graph Build bitince Enter Environment Setup‘a geçin. Bu ekranda Custom anahtarını açıp tur sayısını en alta çekin. Arayüz de ilk denemede turları azaltmayı öneriyor. Sonra Start Dual-World Parallel Simulation, bitince Generate Report.
4. Sanal müşterilere anket yapın. Rapordan sonra Enter Deep Interaction‘a geçin, Send survey to the world bölümünde Select All ile herkesi seçip şunu gönderin:
Bu ürünü bu fiyattan bugün satın alır mıydınız? Evet, hayır ya da kararsızım diye başlayın, sonra tek cümleyle nedenini yazın. Hangi reklam dikkatinizi çekti?Rapor ve cevaplar arayüz dilinde, yani İngilizce gelir. Hepsini Claude’a yapıştırıp “Türkçeye çevir, ilk 3 itirazı ve lansman sayfamda neyi değiştirmem gerektiğini söyle” diyebilirsiniz.
Dürüst olmak gerekirse
- Sanal müşteri, gerçek müşteri değil. Bu kişileri bir dil modeli canlandırıyor; modelin önyargıları cevaplara da geçiyor. Sonuç bir satış tahmini değil, itirazları ve zayıf noktaları önceden görmenin ucuz bir yolu. Gerçek müşteriyle konuşmanın yerini tutmaz.
- Satın alma eylemi yok. Sanal platformlarda kişiler paylaşıyor, beğeniyor, yorum yapıyor ya da hiçbir şey yapmıyor. “Satar mı” sorusunun cevabını anketten ve rapordan, yani bir tahmin olarak alıyorsunuz.
- Maliyet sizde. MiroFish’in kendi notu “tüketim yüksek, önce 40 turdan az deneyin” diyor. Arayüz simülasyon başına ortalama 5 dolar yazıyor, bu proje ekibinin beyanı. Sağlayıcı panelinizden harcama limiti koyun ve küçük başlayın.
- Gizlilik. Yüklediğiniz belge, seçtiğiniz yapay zeka sağlayıcısına ve Zep Cloud’a gidiyor. Müşteri listesi, sözleşme gibi gizli bilgileri koymayın.
- Lisans. AGPL-3.0 kendi kullanımınız için serbest. Aracı değiştirip başkalarına internet üzerinden hizmet olarak sunarsanız kaynak kodunu paylaşma yükümlülüğü doğuyor.
- Proje genç. Arayüzde sürüm v0.1-Preview yazıyor; hata görürseniz mesajı Claude’a yapıştırın.
Özet
MiroFish, bir belgeden sanal insanlar üretip onları sanal bir sosyal medyada konuşturan, sonunda rapor veren açık kaynak bir tahmin motoru. Code sekmesinde repo linkini yapıştırıp “bunu kur” demeniz, bir yapay zeka API anahtarı ve ücretsiz bir Zep anahtarı eklemeniz yeterli. Lansman sayfanızı, fiyatınızı, reklamlarınızı ve hedef müşteri profillerinizi tek belgede toplayın, az turla başlayın, sonunda sanal müşterilere anket yapın. Sonucu kesin cevap olarak değil, lansmandan önce düzeltilecek noktaların listesi olarak okuyun.
