---
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:

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