README.md

metadata

title: XGBoost & Gemini Match Predictor
emoji: ⚽
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit
short_description: Hybrid Football Outcome Predictor with ML & LLM

⚽ XGBoost & Gemini Hibrit Maç Tahmin Radarı

Bu proje, geleneksel makine öğrenmesi algoritmaları (XGBoost) ile üretken büyük dil modellerini (Google Gemini) bir araya getiren hibrit bir spor analiz ve maç tahmin platformudur.

---

🚀 Çalışma Mantığı

1. Sayısal Modelleme (XGBoost):

   • Takımların lig sıralaması, form durumları (son 5 maç puanı) ve eksik/sakat oyuncu sayıları gibi yapılandırılmış verileri işler.
   • Maçın Ev Sahibi Galibiyeti (1), Beraberlik (X) ve Deplasman Galibiyeti (2) olasılık dağılımını hesaplar.

2. Semantik & Niteliksel Analiz (Gemini):

   • XGBoost'un hesapladığı matematiksel olasılıkları girdi olarak alır.
   • Maç hikayesini kurgular, olası gol baremini (2.5 Alt/Üst) tahmin eder ve pozitif beklenen değere (+EV) sahip rasyonel bahis önerileri sunar.

---

🛠️ Kurulum & Yapılandırma (Hugging Face Spaces)

1. API Anahtarının Eklenmesi (Zorunlu)

Gemini analizlerinin çalışması için Google AI Studio üzerinden aldığınız anahtarı Space ayarlarınıza eklemelisiniz:

1. Space sayfanızda Settings sekmesine gidin.
2. Sol menüden Variables and secrets bölümünü açın.
3. New secret butonuna tıklayın:
   • Name: GEMINI_API_KEY
   • Value: (Google AI Studio'dan aldığınız API Anahtarı)
4. Kaydedin.

---

📦 Gereksinimler (requirements.txt)

Space ortamında kullanılan bağımlılıklar:

gradio>=4.0.0
google-genai>=0.1.1
xgboost>=2.0.0
numpy>=1.24.0
scikit-learn>=1.3.0