README.md

metadata

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:

pip install -r requirements.txt

🎯 Uso

Opción 1: Ejecutar localmente

python betpl_gradio.py

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

Opción 2: Google Colab

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

🎨 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