MiroFish: bin kişilik yapay zekâ şehri ve Türkçe rehberi
MiroFish, ürününü ya da fikrini yüzlerce yapay insana gösterip sosyal medyada nasıl yayılacağını simüle eden açık kaynak bir proje. Tarayıcı demosu, kurulum adımları ve maliyet notu.
KALABALIKInstagram'da KALABALIK yazıp geldiysen doğru yerdesin. Linkler ve kurulum adımları bu sayfada.
Bin kişilik bir şehir düşün, hiçbiri gerçek değil. MiroFish, yüklediğin bir ürünü, reklamı ya da fikri yapay insanlara gösteriyor ve onların sosyal medyada bunu nasıl konuştuğunu, tartıştığını ve birbirini nasıl etkilediğini simüle ediyor. GitHub'da 80 binden fazla yıldızı var.
Önce demoyu dene
Kurulumdan önce ne yaptığını görmek için ekibin hazırladığı canlı demoyu aç: 666ghj.github.io/mirofish-demo. Hazır bir kamuoyu senaryosu üzerinde ilişki grafiğini, simülasyonu ve raporu gösteriyor. Hiçbir şey kurman gerekmiyor.
MiroFish ne yapıyor?
Çok ajanlı bir tahmin motoru (AGPL-3.0). Yüklediğin metinden kişilikleri, hafızaları ve ilişkileri olan yapay insanlar üretir, onları sosyal medya benzeri iki platformda konuşturur ve sonunda bir rapor yazar.
git clone https://github.com/666ghj/MiroFish.git
cd MiroFish
cp .env.example .env
npm run setup:all
npm run dev- Dünyayı kuruyor: Yüklediğin metinden (haber, rapor, ürün tanıtımı, hatta bir hikâye) kişileri, kurumları ve aralarındaki ilişkileri çıkarıyor.
- Karakterleri üretiyor: Her yapay insanın kendi kişiliği, hafızası ve davranış biçimi oluyor.
- Simüle ediyor: Bu insanlar iki ayrı sosyal medya benzeri platformda paylaşıyor, yorum yapıyor ve birbirini etkiliyor.
- Rapor yazıyor: Simülasyon bitince bir rapor ajanı ne olduğunu analiz ediyor.
- Konuşturuyor: Simülasyondaki herhangi bir ajanla sohbet edip "neden böyle düşündün?" diye sorabiliyorsun.
Başında doğal dille ne tahmin edilmesini istediğini yazıyorsun, örneğin "Bu ürünü kim alır, neden?".
Kendi bilgisayarına kurulum
Gerekenler:
- Node.js 18 veya daha yenisi
- Python 3.11 ya da 3.12
- uv (Python paket yöneticisi)
1. Projeyi indir ve ayar dosyasını oluştur. Yukarıdaki ilk üç satırı terminalde çalıştır.
2. .env dosyasını doldur. Şu dört değer gerekiyor:
LLM_API_KEY=senin_api_anahtarin
LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
LLM_MODEL_NAME=qwen-plus
ZEP_API_KEY=senin_zep_anahtarin
OpenAI formatında çalışan başka bir model kullanacaksan adresi ve model adını ona göre değiştir. Zep anahtarını app.getzep.com adresinden ücretsiz alabilirsin.
3. Kur ve başlat:
npm run setup:all
npm run dev
Arayüz http://localhost:3000 adresinde açılıyor. Docker kullanıyorsan .env dosyasını doldurduktan sonra docker compose up -d da yeterli.
Maliyet notu
Simülasyonu yapay zekâ modeli yürüttüğü için her tur API kullanımı demek. README bu konuda açıkça uyarıyor: tüketim yüksek, önce 40 turdan kısa simülasyonlarla dene. İlk denemede az sayıda tur seç, API panelinden harcamayı izle.
Bilgiler MiroFish'in resmi GitHub sayfasından ve README dosyasından, 18 Ekim 2026. Yıldız sayısı aynı gün GitHub'dan alındı. Sponsorlu değildir.
Sık sorulanlar
MiroFish ücretsiz mi?
Kodu açık kaynak (AGPL-3.0) ve ücretsiz. Ama simülasyonu bir yapay zekâ modeli çalıştırıyor, bunun için kendi API anahtarını giriyorsun. README simülasyonların çok token harcadığını söylüyor ve önce 40 turdan kısa denemeler yapmanı öneriyor. Tarayıcı demosu ücretsiz.
Demoda kendi ürünümü deneyebilir miyim?
Hayır. Demo, ekibin önceden hazırladığı bir kamuoyu senaryosunu gösteriyor. Ne yaptığını görmek için ideal. Kendi ürününü, reklamını ya da fikrini simüle etmek için projeyi kendi bilgisayarına kurman gerekiyor.
Hangi yapay zekâ modelini kullanıyor?
OpenAI SDK formatını destekleyen her modeli kullanabiliyorsun. README, Alibaba'nın qwen-plus modelini öneriyor. Anahtarı, adresi ve model adını .env dosyasına yazıyorsun.
Zep anahtarı ne işe yarıyor?
Ajanların hafızası Zep Cloud'da tutuluyor. app.getzep.com'dan ücretsiz hesap açıp anahtar alabilirsin; README'ye göre aylık ücretsiz kota basit kullanım için yetiyor.
Sonuçlar gerçeği mi gösteriyor?
Hayır, bir tahmin. Yapay insanlar gerçek müşterilerin yerini tutmaz ama hangi itirazların çıkabileceğini, bir fikrin nasıl yayılabileceğini önceden görmek için iyi bir prova alanı. Önemli kararları gerçek kullanıcılarla da test et.











































