espn-fantasy-basketball

Weekly projections for 9 category head-to-head format ESPN NBA fantasy basketball.

Project Progress

• Environment & Config:
  • Reads ESPN league credentials from environment variables (src/config.py).
• API Integration:
  • Connects to ESPN fantasy basketball using espn_api.
  • Provides functions to create a league instance and summarize teams (src/api/espn_client.py).
• Stat Processing:
  • Computes expected weekly stats for players and aggregates team totals (src/features/stats_processing.py).
• Matchup Comparison:
  • Compares two teams' expected stats and determines category winners (src/features/matchup.py).
• Simulation:
  • Monte Carlo simulation for weekly category outcomes and win probabilities (src/simulation/monte_carlo.py).
• Visualization:
  • Generates grouped bar plots for matchup comparisons (src/viz/plots.py).
• Streamlit App:
  • Interactive UI for selecting teams and viewing matchup projections (app/streamlit_app.py).
• Testing:
  • Unit tests for config, API, stat processing, matchup logic, and plotting (tests/).

Next Steps

• Integrate real player stats and schedules into projections.
• Complete Streamlit UI for full matchup analysis.
• Add more advanced simulation and visualization features.