README.md

---
license: apache-2.0
title: bety
sdk: gradio
emoji: 🚀
colorFrom: green
colorTo: yellow
short_description: bety
---
# ⚽ Sistema de Análisis de Value Betting con Gradio




Sistema profesional para análisis estadístico de partidos de fútbol y detección de value betting.

## 🚀 Características

- **Análisis estadístico completo**: Media, mediana, moda y análisis de volatilidad
- **Modelo de Poisson**: Predicción de probabilidades de goles
- **Kelly Criterion**: Gestión óptima del bankroll
- **Edge Calculation**: Identificación de value betting
- **Interfaz Gradio**: Interfaz web interactiva y fácil de usar
- **Análisis con IA** (opcional): Contexto en tiempo real usando OpenAI GPT-4
- **Generación de PDF**: Reportes profesionales descargables

## 📋 Requisitos

- Python 3.8 o superior
- Archivo CSV con datos históricos de partidos (formato Football-Data.co.uk)

## 🔧 Instalación

1. **Clona o descarga los archivos**

2. **Instala las dependencias**:
```bash
pip install -r requirements.txt
```

## 🎯 Uso

### Opción 1: Ejecutar localmente

```bash
python betpl_gradio.py
```

La aplicación se abrirá automáticamente en tu navegador en `http://localhost:7860`

### Opción 2: Google Colab

```python
# Instalar dependencias
!pip install pandas numpy scipy reportlab openai gradio

# Subir el archivo betpl_gradio.py y ejecutarlo
%run betpl_gradio.py
```

## 📊 Cómo usar la interfaz

### 1. Cargar datos
- Haz clic en "📁 Archivo CSV de partidos"
- Sube tu archivo CSV con datos históricos
- Haz clic en "📊 Cargar Datos"

### 2. Configurar análisis
- Selecciona el **Equipo Local** del dropdown
- Selecciona el **Equipo Visitante** del dropdown
- (Opcional) Ingresa tu **API Key de OpenAI** si quieres análisis web
- (Opcional) Marca la casilla **"Incluir análisis web y de IA"**

### 3. Generar análisis
- Haz clic en **"📈 Analizar Partido"** para ver resultados en pantalla
- O haz clic en **"📄 Generar PDF"** para descargar un reporte completo

## 📈 Pestañas de resultados

1. **📈 Resumen**: Score de confianza y advertencias de riesgo
2. **📊 Estadísticas**: Tabla con media, mediana, moda y volatilidad
3. **💰 Probabilidades y Valor**: Mercados con Edge y Kelly Criterion
4. **🌐 Contexto Web**: Información actualizada del partido (requiere API Key)
5. **🤖 Análisis IA**: Contraste entre modelo y realidad (requiere API Key)
6. **📄 PDF**: Descarga el reporte completo

## 🔑 OpenAI API Key (Opcional)

Para usar las funciones de análisis web y de IA:

1. Obtén una API Key en [OpenAI Platform](https://platform.openai.com/api-keys)
2. Ingresa la key en el campo "🔑 OpenAI API Key"
3. Marca la casilla "Incluir análisis web y de IA"

**Nota**: El sistema funciona perfectamente SIN API Key, solo se omitirán los análisis web y de IA.

## 📁 Formato del CSV

Tu archivo CSV debe tener las siguientes columnas mínimas:

- `HomeTeam`: Equipo local
- `AwayTeam`: Equipo visitante
- `FTHG`: Goles tiempo completo equipo local
- `FTAG`: Goles tiempo completo equipo visitante
- `HTHG`: Goles medio tiempo equipo local
- `HTAG`: Goles medio tiempo equipo visitante
- `HS`: Remates equipo local
- `AS`: Remates equipo visitante
- `HST`: Remates a puerta equipo local
- `AST`: Remates a puerta equipo visitante
- `HC`: Corners equipo local
- `AC`: Corners equipo visitante

Puedes descargar datos de ejemplo desde [Football-Data.co.uk](https://www.football-data.co.uk/data.php)

## 🎨 Mejoras implementadas

Comparado con el código original:

1. ✅ **Interfaz gráfica Gradio** completa y profesional
2. ✅ **Carga dinámica de CSV** desde la interfaz
3. ✅ **Dropdowns automáticos** con equipos disponibles
4. ✅ **API Key opcional** para mayor flexibilidad
5. ✅ **Manejo de errores** robusto con mensajes claros
6. ✅ **Pestañas organizadas** para mejor UX
7. ✅ **Generación de PDF** directamente desde la interfaz
8. ✅ **Modo share** para compartir la app

## 🛠️ Solución de problemas

### Error: "Por favor, primero carga los datos CSV"
- Asegúrate de subir un CSV válido y hacer clic en "Cargar Datos"

### Error: "⚠️ API Key de OpenAI no proporcionada"
- Esto es normal si no ingresaste una API Key
- El análisis básico funcionará sin problemas
- Solo necesitas la API Key para análisis web y de IA

### Los dropdowns no muestran equipos
- Verifica que el CSV tenga las columnas `HomeTeam` y `AwayTeam`
- Asegúrate de hacer clic en "Cargar Datos" después de subir el CSV

## 📝 Licencia

Este código es de uso libre para fines educativos y personales.

## 🤝 Contribuciones

¡Las sugerencias y mejoras son bienvenidas!

---

**Desarrollado con ❤️ para análisis deportivo profesional**