A Python project for generating NFL daily fantasy contest lineups.
As this optimizer runs completely offline, fantasy points per game as provided by sites' players export file is used as player projections. If you would like to provide your own projections, you can edit the values in the column corresponding to average fantasy points per game. Similarly, if you would not like to be exposed to a particular player, giving them an injury status in the proper column will ensure they are not included in any lineups.
To install and use as a Python package:
python3 -m pip install lineup-optimizer
This project supports the following NFL DFS formats:
| Site | Optimize Lineup | Generate Lineups | Export Lineups |
|---|---|---|---|
| DraftKings Full Roster | ✔️ | ✔️ | ✔️ |
| FanDuel Full Roster | ✔️ | ✔️ | ✔️ |
| Yahoo Full Roster | ✔️ | ✔️ | ✔️ |
| DraftKings Captain | ✔️ | ✔️ | ✔️ |
| FanDuel MVP | ✔️ | ✔️ | ✔️ |
| Yahoo Captain | ✔️ | ✔️ | ✔️ |
Clone the repository onto your machine to get started. Ensure you have Python and pip installed, then set up the virtual environment using:
pipenv install -r "requirements.txt"
pipenv shell
This project currently only uses built-in Python modules, so this step is actually not required.
Place the CSV file containing the player pool for the contest you would like to enter into the root directory of the project.
DraftKings or FanDuel: Go to the contest webpage for the contest you would like to enter, or any contest that has the same player pool and format as the contest you would like to enter, and download the players list as a CSV.
Yahoo: Go to the Multiple Contest Entry Tool Page, and download the CSV template for your chosen contest type.
The examples below will use the name "DKSalaries_example.csv" as a placeholder for one such CSV file. You can choose to generate lineups from the command line, or from within a Python script:
To create a single optimized lineup (with 3 players from KC and 2 players from JAX):
python optimize.py FULL_ROSTER "FanDuel_full_roster_example.csv" KC3-JAX2
This will output the lineup to the console:
QB: Patrick Mahomes KC
RB1: Christian McCaffrey SF
RB2: Kyren Williams LAR
WR1: Rashee Rice KC
WR2: Calvin Ridley JAX
WR3: Marquez Valdes-Scantling KC
TE: Noah Fant SEA
FLEX: Travis Etienne Jr. JAX
D: Houston Texans HOU
SALARY: 59900
You can choose to stack a random game by only providing the stack numbers:
python optimize.py FULL_ROSTER "FanDuel_full_roster_example.csv" 3-2
This would choose a random game, and provide a lineup with a 3x2 stack from the teams in that game.
To create a CSV file with multiple lineups:
python3 generate.py FULL_ROSTER 3 "FanDuel_full_roster_example.csv"
This will create a new file with 3 lineups in the directory with a name like "FANDUEL_FULL_ROSTER_export.csv".
You can also import the tool for use in your Python project:
from lineup_optimizer import optimize_lineup
lineup = optimize_lineup("FULL_ROSTER", "DKSalaries_example.csv")
print(lineup)