Update README.md

README.md

@@ -1,10 +1,55 @@
 ---
-title: Goshawk GeminiPro
-emoji: 📊
-colorFrom: green
-colorTo: pink
-sdk: static
+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
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# ⚽ 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