Kaderini Seç

Tarihin derinliklerinde geçen, yapay zeka destekli interaktif bir macera oyunu.

Genel Bakış

Kaderini Seç, Mistral AI ile desteklenen bir Flask tabanlı web uygulamasıdır. Oyuncular dört farklı tarihi karakterden birini seçerek aşk, macera, savaş ve siyasi entrika dolu hikayelere atılır. Her seçim, yapay zeka tarafından anlık olarak üretilen benzersiz bir hikaye deneyimi sunar.

Karakterler

Karakter	Dönem	Konum
Korsan	17. yy	Karayipler
Mösyö	18. yy	Fransa
Şövalye	12. yy	Haçlı Seferleri
Kaşif	15. yy	Keşifler Çağı

Gereksinimler

• Python 3.9+
• Mistral AI API anahtarı

Kurulum

1. Depoyu klonlayın:

git clone <repo-url>
cd kaderini-sec

2. Sanal ortam oluşturun ve aktifleştirin:

python -m venv venv
source venv/bin/activate

3. Bağımlılıkları yükleyin:

pip install -r requirements.txt

4. .env dosyasını oluşturun ve API anahtarınızı ekleyin:

MISTRAL_API_KEY=api_anahtariniz

Çalıştırma

Uygulamayı başlatın:

python app.py

Tarayıcınızda şu adresi açın:

http://localhost:3000

Teknolojiler

• Backend: Flask, Flask-CORS
• AI: LangChain, Mistral AI
• Frontend: HTML, CSS, Vanilla JavaScript
• Konfigürasyon: python-dotenv

Proje Yapısı

.
├── app.py              # Flask backend ve API endpointleri
├── config.py           # API anahtarı konfigürasyonu
├── index.html          # Frontend arayüzü
├── requirements.txt    # Python bağımlılıkları
├── .env                # Ortam değişkenleri
└── README.md           # Proje dokümantasyonu

API

POST /api/chat

Yapay zeka ile etkileşim kurmak için kullanılan endpoint.

İstek:

{
  "messages": [
    { "role": "user", "content": "Korsan" }
  ]
}

Yanıt:

{
  "karakterAdi": "...",
  "karakterArkaplan": "...",
  "karakterDt": "...",
  "muhtemelAksiyonlar": ["...", "...", "..."],
  "olaylar": "..."
}

Lisans

Bu proje MIT lisansı altında sunulmuştur. Detaylar için LICENSE dosyasına bakın.