A Python application to track and report NFL season pool picks and points for league play
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Documentation Status made-with-python Updates GitHub license Code style: black


NFLPool is hosted at nflpool.xyz.

NFLPool is a variation of MLBPool2. Unlike fantasy football, players make their picks once, before the season starts. Players don't have to worry about getting their picks in every week or micro managing their team. Before the NFL season begins, players choose the teams they believe will win and lose each division; wildcard winners; and which players will lead in certain offensive and defensive statistics. Points are assigned to each category and the player who has the most points at the end of the NFL season after week 17 wins. Unlike MLBPool2, players do not have the ability to change their picks at the halfway point of the season. If you make a unique pick - the only person to choose a player or team in a given category - you earn double points for that pick.

nflpool application

The NFLPool application is written in Python 3 and uses statistics from MySportsFeeds who offer free developer access for non-commercial purposes. You will need to sign up for a MySportsFeed account to use the application. The nflpool app uses JSON feeds from MySportsFeeds for all statistics.

NFLPool is uses the Pyramid Python web application framework.
nflpool.xyz is hosted on Digital Ocean running Fedora and nginx.

For for more information on the league or rules, visit the website.

The NFLPool application is licensed under the MIT license.


  • NFLPool is under active development and these are subject to change
  • Python 3.6+
  • SQLite
  • SQLAlchemy 1.2+
  • Pyramid 1.9+
  • MySportsFeeds account.


NFLPool documentation is available on ReadtheDocs, including an Administrator's guide to setting up NFLPool and updating it each season and a User Guide for players.


NFLPool (and MLBPool2) are my first Python applications and I'm sure the code is ugly in places - contributions welcome! Please see the Code of Conduct.

Imposter syndrome disclaimer: I want your help. No really, I do.

There might be a little voice inside that tells you you're not ready; that you need to do one more tutorial, or learn another framework, or write a few more blog posts before you can help me with this project.

I assure you, that's not the case.

While I don't have clear contributing guidelines at this time, please fork the repo and send me a pull request!
I'm new to Python too, and I would love the help and learn how to make things better.

And you don't just have to write code. You can help out by writing documentation, tests, or even by giving feedback about NFLPool. (And yes, that includes giving feedback about the contribution guidelines.)

Thank you for contributing!

(Adapted from Adrienne Lowe's Imposter Syndrome Disclaimer)


I started learning Python in early 2016 as a hobby with a goal of building the scoring automation for NFLPool and MLBPool2 instead of having to calculate each player's score manually.

I would not have learned Python without the help of: