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