Videodaki araç: MiroFish

MiroFish'i bilgisayarıma kurup açmanı istiyorum. Yazılımcı değilim. Komutları sen çalıştır, ben sadece onay vereyim. Her adımda ne yaptığını tek cümleyle, sade Türkçe söyle.

Proje: https://github.com/666ghj/MiroFish

1. Projeyi kullanıcı klasörüme, ~/MiroFish klasörüne indir. Klasör zaten varsa yeniden indirme, onu kullan.
2. README'deki önerilen kurulumu (Source Code Deployment) izle. Gerekenler: Node.js 18 ya da üstü, Python 3.11 ya da 3.12 (3.13 olmaz) ve uv. Önce hangilerinin kurulu olduğuna bak, sadece eksik olanı kur. "Docker ile kur" dersem onun yerine README'deki Docker yolunu kullan.
3. .env.example dosyasını .env adıyla kopyala. İçini tamamen sil ve sadece şu dört satırı yaz:
LLM_API_KEY=
LLM_BASE_URL=https://api.openai.com/v1
LLM_MODEL_NAME=gpt-4o-mini
ZEP_API_KEY=
LLM_BOOST_ ile başlayan satırları ve ZEP_API_URL satırını ekleme.
4. Benden iki anahtar iste: OpenAI API anahtarım ve Zep anahtarım. Ben verene kadar bekle. Anahtar uydurma, örnek değer yazma. Anahtarları sadece .env dosyasına koy, sohbette tekrar yazma. Anahtarı sohbete yazmak istemezsem .env dosyasını aç, kendim yazayım.
5. OpenAI anahtarını, anahtarı ekrana yazdırmadan, çok küçük bir istekle dene. Bakiye yoksa bana sade bir dille söyle. gpt-4o-mini açılmıyorsa adı gpt-5 ile başlayan, kapanma tarihi olmayan ucuz bir model öner (örneğin gpt-5.6-luna). MiroFish'in kodu sadece gpt-5 ailesi için ayar yapıyor; başka yeni modeller kurulumdan sonra hata verebilir. O modeli MiroFish'in göndereceği gibi dene: JSON modu açık, temperature yok, max_completion_tokens ile küçük bir istek. Çalışırsa ve ben onaylarsam .env dosyasına yaz.
6. README'deki kurulum komutunu çalıştır (npm run setup:all). Kurulum uzun sürebilir; arka planda çalıştır ve bitmesini bekle, zaman aşımını hata sayma. Hata çıkarsa sebebini bul ve düzelt. Aynı yerde üç kez takılırsan dur, bana ne olduğunu anlat.
7. Programı npm run dev ile başlat. Kapanmasın diye ayrı bir terminal penceresinde çalıştır ve o pencereyi kapatmamamı söyle. Açılınca tarayıcıda http://localhost:3000 adresini aç.
8. Programı internete açma: tünel, ngrok, port yönlendirme, sunucuya kurma yok. MiroFish varsayılan olarak aynı Wi-Fi'daki cihazlardan da açılabiliyor; bunu bana tek cümleyle söyle, bunun için kodu ya da ayarları değiştirme.
9. Bilgisayar şifremi isteyen bir adım olursa şifremi sohbette isteme. Ne yapmam gerektiğini söyle, ben yapayım.

Bitince şunları söyle: Program açıldı mı, MiroFish klasörü nerede, bir dahaki sefere nasıl açacağım.

MiroFish'te ürünümü provaya sokacağım. Bunun için bir ürün metni dosyası ve bir simülasyon sorusu yaz.
Köşeli parantezli yerler boş kaldıysa önce bana tek tek sor ve cevaplarımı bekle; ürün uydurma.

Ürünüm: [ÜRÜNÜN ADI, NE OLDUĞU, FİYATI, KARGOSU, NEREDEN SATILIYOR]
Kime satmak istiyorum: [KİTLEN, BİLDİĞİN KADARIYLA]
Merak ettiğim: [ÖĞRENMEK İSTEDİĞİN ŞEY, ÖRNEĞİN "EN ÇOK HANGİ İTİRAZ GELİR?"]

Metin için kurallar:
- İngilizce yaz. MiroFish resmî olarak sadece Çince ve İngilizceyi destekliyor.
- Ürünü kısa anlat: ne olduğu, fiyatı, kargosu, nereden satıldığı, nasıl duyurulduğu.
- Ürünü görecek ve konuşacak kitleyi 8-12 ayrı rol olarak yaz. Her rol tek satır: kim olduğu, ürüne neden ilgi duyar, neye takılır. Seveni de sevmeyeni de koy; rakip satıcıyı ve şikâyet yazan müşteriyi de ekle. Her rol bir karakter oluyor. Rol ne kadar çoksa karakter o kadar çok.
- Ürünümün kendi adı dışında marka, şirket ve platform adı yazma. "Instagram" yerine "social media" yaz. Adı geçen şirketler de karaktere dönüşüp yer kaplıyor.
- Tartışılacak noktaları ayrı bir başlıkta yaz: fiyat, kargo, güven, iade gibi.
- Metin, merak ettiğim soruyla bitsin.
- Bir sayfayı geçmesin. Metin uzadıkça masraf ve süre artıyor.

Dosyayı ~/MiroFish klasörüne urun.md adıyla kaydet ve klasörü Finder'da (Windows'ta Dosya Gezgini'nde) aç.

Sonra MiroFish'in ikinci kutusuna yapıştıracağım soruyu yaz: İngilizce, tek paragraf, platform adı geçmesin. Soruyu ayrı bir kutuda ver ki kolayca kopyalayayım. En sonda metni ve soruyu Türkçe, iki üç cümleyle özetle.

MiroFish'te simülasyonum çalışıyor. Raporu almadan önce bütün karakterlere aynı soruyu sormanı istiyorum.

Sıra neden önemli: MiroFish'te bilinen bir hata var (https://github.com/666ghj/MiroFish/issues/845). Turlar bitince simülasyon kendiliğinden durmuyor, rapor düğmesi de açılmıyor. Durdurunca rapor açılıyor ama karakterler artık cevap veremiyor. O yüzden önce sor, sonra durdur.

Soru: [SORMAK İSTEDİĞİNİ YAZ. BOŞ BIRAKIRSAN ŞU SORULSUN: "Would you buy this product? Why or why not? What would change your mind?"]

1. ~/MiroFish/backend/uploads/simulations/ altındaki en yeni sim_ klasörünü bul. Klasörün adı simülasyonun kimliği. Emin olamazsan bana sor; tarayıcının adres çubuğundan sim_ ile başlayan kodu vereyim.
2. GET http://localhost:5001/api/simulation/<kimlik>/run-status ile bak: twitter_completed ve reddit_completed ikisi de true olmalı. Değilse birkaç dakikada bir tekrar bak, bitmesini bekle.
3. POST http://localhost:5001/api/simulation/env-status, gövde {"simulation_id": "<kimlik>"}. env_alive true olmalı. false ise dur ve bana söyle; simülasyon zaten kapanmış demektir.
4. Soruyu İngilizceye çevir, içine ürünün adını yaz (ürün metni ~/MiroFish/urun.md dosyasında) ve herkese sor: POST http://localhost:5001/api/simulation/interview/all, başlıklar "Content-Type: application/json" ve "Accept-Language: en", gövde {"simulation_id": "<kimlik>", "prompt": "<soru>", "platform": "reddit", "timeout": 600}. Bu isteği tek sefer gönder; cevaplar 10 dakikaya kadar sürebilir. Komutu arka planda çalıştırıp cevabı ~/MiroFish/cevaplar.json dosyasına yazdır ya da komutun bekleme süresini en az 11 dakika yap. Komut yarıda kesilirse soruyu tekrar gönderme: cevapları POST http://localhost:5001/api/simulation/interview/history ile al (gövde {"simulation_id": "<kimlik>", "platform": "reddit", "limit": 500}) ve sadece son sorunun cevaplarını kullan. Orada da yoksa birkaç dakika bekleyip tekrar bak; yine yoksa bana sor.
5. Cevaplarda isim yok; reddit_0, reddit_1 gibi numaralar var. ~/MiroFish/backend/uploads/simulations/<kimlik>/simulation_config.json dosyasında agent_configs altındaki agent_id ve entity_name alanlarıyla her numarayı karakterin adıyla eşleştir.
6. Bana Türkçe bir tablo göster: karakter, alır mı (evet / hayır / kararsız), sebebi tek cümleyle. Altına en sık geçen üç itirazı yaz. Hepsini ~/MiroFish/cevaplar.md dosyasına da kaydet.
7. Sonra başka bir soru sormak isteyip istemediğimi sor. İstersem 4-6. adımları yeni soruyla tekrarla.
8. "Yok" deyince simülasyonu durdur: POST http://localhost:5001/api/simulation/stop, gövde {"simulation_id": "<kimlik>"}. Durdurma birkaç dakika sürebilir (en fazla 11 dakika): bu komutu da arka planda ya da uzun bekleme süresiyle çalıştır ve tekrar gönderme. Cevapta pending gelirse ya da komut yarıda kesilirse run-status'ta runner_status "stopped" olana kadar birkaç dakikada bir bak. Sonra bana tarayıcıda Generate Report düğmesine basmamı söyle.
9. Simülasyon sekmesini kapattığımı söylersem o adresi yeniden açtırma; açılınca simülasyon baştan başlar. Onun yerine raporu sen başlat: POST http://localhost:5001/api/report/generate, başlıklar "Content-Type: application/json" ve "Accept-Language: en", gövde {"simulation_id": "<kimlik>"}. Sonra cevaptaki report_id ile tarayıcıda http://localhost:3000/report/<report_id> adresini aç.
10. "Rapor hazır" dediğimde ~/MiroFish/backend/uploads/reports/ altındaki en yeni full_report.md dosyasını bul ve bana Türkçe, kısa bir özet çıkar.

MiroFish'in kodunu ve arayüzdeki ayarları değiştirme.