A complete single page application using a REST API for the backend and Vue.js for the frontend. I do not intend for this to be a long-term project, but it has been a valuable way for me to learn web frameworks, REST APIs, HTTP Requests, and advanced Python techniques.
This is a free alternative to other paid fantasy subscriptions that help guide you through your fantasy football drafts. The Fantasy Football Helper App pulls in data from fantasypros.com using a web scraping process. The process includes a value based method to rank players using ADP (Average Draft Position) and VOR (Value Over Replacement), as well as a single feature GMM tiering method (Gaussian Mixture Modeling) for position groups. I will push the up to date player data to the repo as needed when I test it this upcoming season.
The Vue.js frontend dev server and FastAPI backend server will need to be launched prior to using the app. The frontend web page will ask for your snake draft position (currently built for 12 teams only but can be adjusted in the code), and then the type of scoring you would like to use (STD for Standard, HALF for Half PPR, and PPR for Full PPR).
When the page is loaded with the above entered information, you can start following your fantasy football draft and check off each player as they are drafted. For instance, if you are drafting 3rd overall, you will need to record the first two picks, and each pick after until your pick comes up again. When it is your turn to pick, you can select the "Suggest Pick" button and the frontend server will send a list of dictionaries containing the drafted players to the backend API at "/players/draft-pick". The API will send a json response back containing the recommended player to draft based on your current roster.
Please note that there are bugs and the code isn't completely cleaned or optimized. Also the recommendation algorithm could use some tweaking to be more accurate and intuitive. Hopefully there will be good testing data this season!
- Python 3.6 or higher
- IDE of your choice
- Node.js (Needed in order to run the npm commands in the installation)
- Clone the repo
git clone https://github.com/tbakely/thefantasybot.git
- Change directory to the cloned repository and install required python packages
cd thefantasybot pip install -r requirements.txt - Install NPM packages
npm install
- Run the web scraper for up to date draft data (optional)
python draft_boards.py
- Launch the backend server
python root/backend/app/main.py
- Launch the frontend dev server
cd root/frontend/thefantasybot-frontend npm run dev - Enter the frontend server domain from the above step in your browser e.g. http://localhost:5174/
- You will have to enter two prompts when the page launches, the first is the snake order position you are drafting (pick 1-12) and then the type of scoring your fantasy league is using (STD, HALF, or PPR).
- When your fantasy draft starts, use the checkbox under the "Draft Board" table to CAREFULLY select each player that has been drafted before, during, and after your pick all the way to the end of the draft.
- When it is your time to pick, the browser will alert you and let you use the "Suggest Pick" button. If you try to use "Suggest Pick" when it is not your turn, the browser will alert you.
- Show Players
- Toggle button that hides and shows the Draft Board table
- Toggle Search
- Hides and shows the player filter and search form
- Show Drafted Players
- Hides and shows the Drafted Players table (below the Draft Board table)
- Show My Drafted Players
- Shows and hides the your currently drafted roster
- Suggest Pick
- Sends a POST request with a list of dictionaries containing the already drafted players to the FastAPI /players/draft-pick node and returns the recommended pick based on your current roster
- The ascending/descending sorting function in App.vue is currently disabled because it causes the player selection to not work correctly. Low priority
- Cannot undo drafting a player once they've been selected without advancing the overall draft pick number. Be careful when drafting, as misclicking a player will require you to restart the app in order to not mess up the backend algorithm.
- The player filter and search form will be layered on top of the draft board table if the screen is minimized too much. The CSS formatting was not properly planned out in advance since I was learning CSS on the fly. I will make updates eventually but it is low priority
- The recommendation algorithm in players.py is still a work in progress and may not suggest the most optimal player after all starters have been drafted.
- There are a few other bugs that I can't think of at the moment, but they do not affect the main purpose of the app. I will add to this list as I encounter them.
Distributed under the MIT License. See LICENSE.txt for more information.