Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/joewlos/fantasy_football_monte_carlo_draft_simulator
Monte Carlo Fantasy Football Draft Simulator Featuring FastAPI, NextUI, and ODMantic
https://github.com/joewlos/fantasy_football_monte_carlo_draft_simulator
fantasy-football monte-carlo nextjs nextui odmantic pydantic python scikit-learn
Last synced: 9 days ago
JSON representation
Monte Carlo Fantasy Football Draft Simulator Featuring FastAPI, NextUI, and ODMantic
- Host: GitHub
- URL: https://github.com/joewlos/fantasy_football_monte_carlo_draft_simulator
- Owner: joewlos
- License: mit
- Created: 2024-06-23T22:41:49.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-09-06T18:26:58.000Z (5 months ago)
- Last Synced: 2024-11-15T05:24:19.703Z (2 months ago)
- Topics: fantasy-football, monte-carlo, nextjs, nextui, odmantic, pydantic, python, scikit-learn
- Language: TypeScript
- Homepage:
- Size: 9.81 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Monte Carlo Fantasy Football Draft Simulator
### Featuring [FastAPI](https://fastapi.tiangolo.com/), [NextUI](https://nextui.org/), and [ODMantic](https://art049.github.io/odmantic/)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/release/python-3120/)
[](https://pydantic.dev)
## How Does The Simulator Work?
In previous fantasy football drafts, I have struggled to pick the right players. At the start, I selected players whose point projections were not dramatically different than the projections of players who were still available in later rounds. At the end, I failed to draft backups for players who were at the most risk of injury.
This project is my attempt to solve both of those problems. To better estimate whether a player is especially valuable in a given round, a Monte Carlo simulation uses a logistic regression of historical draft data to guess which players will be available in later rounds of the draft, ensuring that I never pick a player who is easily replaceable. And to more accurately anticipate which players need strong, rostered backups (not streamers), injuries and other setbacks are randomly assigned to players, based on historical data, so I always load up on talented individuals in my most at-risk positions.
## Running The Simulator
To get the simulator started, you must have [Docker](https://docs.docker.com/get-started/get-docker/) installed on your machine.
Clone this repository, and run in its directory:
```bash
docker-compose up -d
```
The frontend of the application will then be viewable on `localhost:3000`.
To correctly return results for your league, you'll need to tune the variables in `backend/models/config.py` to your league's settings and create a couple of CSV files:
### Players File
This file includes player names, positions, and projected points for the current NFL season from any resource you choose, like [The Athletic](https://www.nytimes.com/athletic/5475262/2024/05/29/2024-fantasy-football-cheat-sheet-generator-customizable-rankings-and-projections-tool/). The projected points should align with your league's scoring rules.
The following columns are required:
- Season
- Player
- Pos
- Team
- Projected FFP
### Historical Players
Like `players.csv`, this file should include player names, positions, and projected points for previous seasons. Additionally, it should include a column that tallies the actual number of points a player scored in that year.
The following columns are required:
- Season
- Player
- Pos
- Team
- Projected FFP
- Actual FFP
### Historical Drafts
This file informs the logistic regression that models how other teams in your league are predicted to pick. Ideally, it should be a reformatted download of your league's draft history for previous years. For example, [Sleeper](https://docs.sleeper.com/) provides an API for accessing draft histories.
The following columns are required:
- Pick
- Pos
### Teams
This file provides the details for each team in your league. Other information, like whether the simulation should replicate a snake draft, should be contained within the `.env` file for FastAPI, which is read by `backend/models/config.py`.
The following columns are required:
- Name
- Order `(draft order)`
- Owner
- Simulator `(True/False or 1/0)`
Technically, more than one team may be the simulator – or be owned by the user executing the program - allowing the user to test every pick of the draft.
## Screenshots
The following screenshots are samples from the NextUI frontend, which automatically includes both `dark` and `light` themes that require very little customization.
### Dark Theme
### Light Theme
## Contributing
The program is ready for 2024 fantasy football drafts, but it is still a work in progress. If you find it valuable but notice bugs, need changes, or require additional features, [open an issue](https://github.com/joewlos/fantasy_football_monte_carlo_draft_simulator/issues) or fork to [start a PR](https://github.com/joewlos/fantasy_football_monte_carlo_draft_simulator/pulls).
Thank you for your interest, and good luck in your draft!