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