🏆 FantAI

Assistente intelligente per l'asta del Fantacalcio Mantra.

Cosa fa

FantAI ti aiuta durante l'asta del fantacalcio con il sistema Mantra:

• 📊 Database giocatori — Statistiche degli ultimi 5 anni (fantamedia, gol, assist, presenze) da fantacalcio.it
• 🎯 Valutazione asta — Ti dice se un giocatore vale il prezzo proposto, suggerisce alternative
• 📋 Gestione rosa — Traccia i tuoi acquisti, mostra copertura moduli con percentuale
• 💡 Suggerisci top 11 — Per ogni formazione, suggerisce i migliori giocatori disponibili rispettando il budget
• 👥 Tracker avversari — Monitora cosa comprano gli altri e quanto spendono
• ⭐ Preferiti e note — Segna giocatori da tenere d'occhio, appunti per l'asta
• 📊 Info SOS Fanta — Guida asta, formazioni tipo, rigoristi, gerarchie portieri (scraping automatico)

Requisiti

• Python 3.11+
• Connessione internet (per scraping dati)

Installazione

cd FantAI
python3 -m venv .venv
source .venv/bin/activate
pip install flask pandas beautifulsoup4 lxml openpyxl requests rich

Avvio

python webapp.py

Apri http://localhost:5000 dal browser (PC o telefono sulla stessa rete).

Deploy su Raspberry Pi 4

L'app gira come servizio systemd con gunicorn:

# Installazione
python3 -m venv .venv
source .venv/bin/activate
pip install flask flask-compress pandas numpy requests beautifulsoup4 lxml openpyxl gunicorn

# Avvio manuale
gunicorn -w 2 -b 0.0.0.0:5000 webapp:app --timeout 120

# Service systemd (auto-start al boot)
sudo systemctl enable fantai
sudo systemctl start fantai

Accedi da http://192.168.1.26:5000 (o da telefono sulla stessa rete).

Ottimizzazioni RPi

• Gzip+Brotli — pagina 72KB → 17KB via flask-compress
• Cache endpoint — /api/svincolati e /api/player_tags calcolati una volta, serviti in <50ms
• Cache profili — scraping fantacalcio.it con TTL 24h
• Scraping in background — non blocca lo startup
• Bottone aggiornamento manuale — in ⚙️ Impostazioni per forzare refresh dati

Struttura

FantAI/
├── webapp.py              # Flask server
├── templates/index.html   # Frontend (single page app)
├── static/moduli/         # Immagini formazioni Mantra
├── src/
│   ├── fantacalcio.py     # Scraper statistiche fantacalcio.it
│   ├── listone.py         # Scraper listone giocatori
│   ├── sosfanta.py        # Scraper SOS Fanta (guide, formazioni, rigoristi)
│   ├── valuation.py       # Motore di valutazione giocatori
│   └── league_roster.py   # Parser rose della lega
├── data/
│   ├── fantacalcio/       # Stats 5 stagioni (CSV)
│   ├── listone_2025_26.csv
│   ├── mapping_nomi.csv   # Mapping nomi listone ↔ database
│   └── Rose_*.xlsx        # Rose della lega (riferimento prezzi)

Aggiornamento per nuova stagione

1. Listone — Carica il nuovo CSV da ⚙️ Impostazioni
2. Link SOS Fanta — Aggiorna gli URL quando escono le nuove guide
3. Mapping nomi — Compila data/mapping_nomi.csv per i giocatori non riconosciuti
4. Stats — Si aggiornano automaticamente all'avvio se manca la stagione corrente

Fonti dati

Fonte	Cosa fornisce
fantacalcio.it	Quotazioni, ruoli Mantra, fantamedie, statistiche 6 stagioni, profili giocatori
SOS Fanta	Guide asta, formazioni tipo, rigoristi, fasce di prezzo

License

MIT