fantasyfb

Fantasy football league simulation and optimization toolkit. Pulls projections from nflverse data, syncs roster state from a Yahoo Fantasy league, and runs Monte Carlo season simulations to value pickups, trades, and draft picks.

Docs: https://tefirman.github.io/fantasyfb/

Install

pip install fantasyfb

For local development:

git clone https://github.com/tefirman/fantasyfb.git
cd fantasyfb
pip install -e ".[dev]"

Python 3.10+ is required.

Quickstart

import fantasyfb as fb

league = fb.League(name="My Team")
schedule_sim, standings_sim = league.season_sims(postseason=True)
print(standings_sim[["team", "wins_avg", "playoffs", "winner"]])

fb.League(name=...) reads from the Yahoo Fantasy API, so you'll need oauth2.json (and .env with CONSUMER_KEY / CONSUMER_SECRET) set up alongside the script. See the yahoo_oauth docs for a walkthrough.

Command-line tools

After install, four entry points are on your PATH:

Command	Source	Use
`fantasyfb`	`fantasyfb.league:main`	Weekly projections + lineup analysis
`snake-draft`	`fantasyfb.drafts.snake:main`	Live snake-draft cockpit
`salary-cap-draft`	`fantasyfb.drafts.salary_cap:main`	Live salary-cap (auction) draft tool
`draft-prep`	`fantasyfb.drafts.prep:main`	Pre-draft tiers / VORP / mocks

# Weekly run for a team
fantasyfb --team "My Team" --sims 1000 --adds --drops

# Pre-draft analytics
draft-prep tiers --team "My Team"
draft-prep mock --team "My Team" --adp ADP.csv --my-pick 7 --sims 50

# Draft-day cockpit
snake-draft --team "My Team" --adp ADP.csv
salary-cap-draft --team "My Team"

Run any command with --help for the full option list.

NFL data (stats, schedules, rosters) is cached to disk for 24 hours, so repeated runs within that window work offline. Past the 24h mark you'll need a live connection again to refresh the cache — see nflreadpy caching for details and the --refresh-cache flag.

Public API

from fantasyfb import (
    League,                            # main entry point
    FantasyScorer,                     # scoring rules -> points
    MatchupModel, ProjectionEngineV2,  # projection internals
    LineupOptimizer,
    SeasonSimulator, ScheduleManager,
    NflreadpyProvider,                 # default data backend
)

Lower-level utilities live in submodules and can be imported directly:

from fantasyfb.drafts.tools import compute_vorp, assign_tiers, MockDraft
from fantasyfb.drafts.snake_cockpit import build_board, view_best
from fantasyfb.sim.backtest import run_backtest, evaluate
from fantasyfb.io.excel_exporter import FantasyExcelExporter

Subpackage	Purpose
`fantasyfb.league`	Top-level `League` class
`fantasyfb.configs`	League / scoring presets
`fantasyfb.drafts`	Snake, salary-cap, prep, shared draft math
`fantasyfb.data`	Yahoo client + nflverse providers
`fantasyfb.scoring`	Scoring, lineup optimization, matchups
`fantasyfb.projections`	V2 projection engine, walk-forward fitter
`fantasyfb.sim`	Season simulation, backtests, schedule
`fantasyfb.analysis`	WAR, move analysis
`fantasyfb.io`	Excel export

Development

pip install -e ".[dev]"
pytest                       # full test suite
python -m build              # produce sdist + wheel under dist/

The tests/ directory pulls a small slice of nflverse parquet data on first run; subsequent runs are cached locally.

License

MIT. See LICENSE.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fantasyfb-0.8.1.tar.gz (195.4 kB view details)

Uploaded Aug 24, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fantasyfb-0.8.1-py3-none-any.whl (144.2 kB view details)

Uploaded Aug 24, 2026 Python 3

File details

Details for the file fantasyfb-0.8.1.tar.gz.

File metadata

Download URL: fantasyfb-0.8.1.tar.gz
Upload date: Aug 24, 2026
Size: 195.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for fantasyfb-0.8.1.tar.gz
Algorithm	Hash digest
SHA256	`b66d25d5ab983a3e247552d08ae77568ab63005de52f1a3c8fb2718736a2eac6`
MD5	`4e962379c4dcdd02a03fa6909179bb83`
BLAKE2b-256	`f26a97a1dd2a5cbea49af95e972852e2276698f5a6485e0abf7a1fe03d7a228a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fantasyfb-0.8.1.tar.gz:

Publisher: publish.yml on tefirman/fantasyfb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fantasyfb-0.8.1.tar.gz
- Subject digest: b66d25d5ab983a3e247552d08ae77568ab63005de52f1a3c8fb2718736a2eac6
- Sigstore transparency entry: 2579847084
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: tefirman/fantasyfb@8e5288b230891521d7e39f823f095aa1b0f2b1e7
- Branch / Tag: refs/tags/v0.8.1
- Owner: https://github.com/tefirman
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@8e5288b230891521d7e39f823f095aa1b0f2b1e7
- Trigger Event: release