Fantasy Draft Assistant
Never miss a value pick again. Real-time player recommendations powered by live game data and season-long stats, right when you need them -- during your fantasy draft.
The Problem
Your fantasy draft is live. The clock is ticking. You need to decide between three players, but you don't know who's been hot lately, who's dealing with a minor tweak, or which position is about to run dry. You're tabbing between five browser windows and still guessing.
The Solution
Fantasy Draft Assistant merges live game performance with full-season stats to give you a ranked draft board that updates in real time. It knows who's on fire tonight, which positions are getting scarce, and where the value picks are hiding.
+--------------------------------------------------+
| FANTASY DRAFT ASSISTANT — NBA Points League |
| Round 7, Pick 3 | Your roster: 6/13 filled |
+--------------------------------------------------+
| |
| BEST AVAILABLE |
| ┌──────────────────────────────────────────┐ |
| │ 1. Darius Garland (PG/SG) — VOR: +14.2 │ |
| │ Season: 21.3 pts, 8.1 ast, 2.4 3pm │ |
| │ Last 10: 24.8 pts (+17% from avg) │ |
| │ LIVE: 28 pts at halftime tonight │ |
| │ >> RECOMMENDED — fills PG need │ |
| ├──────────────────────────────────────────┤ |
| │ 2. Tyler Herro (SG/SF) — VOR: +11.8 │ |
| │ Season: 23.7 pts, 5.2 reb, 4.8 ast │ |
| │ Last 10: 21.1 pts (-11% from avg) │ |
| ├──────────────────────────────────────────┤ |
| │ 3. Walker Kessler (C) — VOR: +10.4 │ |
| │ Season: 12.1 pts, 9.8 reb, 2.9 blk │ |
| │ Last 10: 14.3 pts (+18% from avg) │ |
| │ >> SLEEPER — blocks upside │ |
| └──────────────────────────────────────────┘ |
| |
| POSITIONAL SCARCITY ALERT |
| PG: 4 quality options left (SCARCE) |
| C: 7 quality options left (OK) |
| SF: 11 quality options left (DEEP) |
+--------------------------------------------------+
Features
- Live context — Sees who's performing right now in tonight's games
- Value over replacement — Ranks players relative to the next-best option at their position
- Positional scarcity — Warns you when a position is drying up
- Trend detection — Flags players trending up or down over the last 10 games
- Sleeper picks — Surfaces under-drafted players with recent breakout signals
- Multi-format — Supports points leagues, category leagues, and roto
Quick Start
1. Install dependencies
pip install requests
2. Set your API key
Requires a Shipp.ai API key for live game context -- get 5,000 free credits/day at platform.shipp.ai.
export SHIPP_API_KEY="your-api-key-here"
3. Run the draft assistant
# NBA points league draft
python scripts/draft_agent.py --sport nba --format points
# NBA 9-category league
python scripts/draft_agent.py --sport nba --format categories
# MLB roto league (spring training scouting mode)
python scripts/draft_agent.py --sport mlb --format roto
# Exclude already-drafted players
python scripts/draft_agent.py --sport nba --format points --drafted "LeBron James,Nikola Jokic,Luka Doncic"
4. During your draft
The assistant outputs a ranked board of available players. After each pick:
- Mark the player as drafted (remove from available pool)
- Add your pick to your roster
- The board re-ranks based on your new positional needs
How It Works
- Live game scan — Connects to live sports feed for current game data
- Season stats pull — Fetches per-game averages and recent game logs from public stats APIs
- Merge and rank — Combines live signals (hot/cold) with season baselines
- VOR calculation — For each position, computes value above the replacement-level player
- Scarcity adjustment — Positions with fewer quality options get a draft priority boost
- Output — Sorted recommendations with context on why each player ranks where they do
Data Sources
| Source | Data | Auth Required |
|---|---|---|
| Live game feed (via Shipp.ai) | Current game scores, player performance | API key (free tier) |
| balldontlie.io | NBA season stats, game logs | None |
| statsapi.mlb.com | MLB stats, spring training, rosters | None |
Configuration
| Environment Variable | Required | Description |
|---|---|---|
SHIPP_API_KEY |
Yes | API key for live game data |
License
MIT
Powered by Shipp.ai real-time sports data
Release files for fantasy-draft-assistant 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fantasy_draft_assistant-0.1.0.tar.gz | 37.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fantasy_draft_assistant-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 53.8 kB
Release files / fantasy_draft_assistant-0.1.0.tar.gz
| Download URL | fantasy_draft_assistant-0.1.0.tar.gz |
|---|---|
| Size | 37.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
52701dfcf7342307a575d9db0e7e634a85afa0e99eeee7039e32351e6aaea229
|
|
BLAKE2b-256 checksum How to use checksums |
5bcc7d5b6af5116e01509df58b93561ee2b58d25175589c19735b01b90a1edcb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.12
|
Release files / fantasy_draft_assistant-0.1.0-py3-none-any.whl
| Download URL | fantasy_draft_assistant-0.1.0-py3-none-any.whl |
|---|---|
| Size | 16.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b34870733663e14fe021980e65408cfe39d4dd1631bf2aabe6484a9b78c5d126
|
|
BLAKE2b-256 checksum How to use checksums |
77313d8661a41d402f5b92f45269fc8363c6f4efe6177ade1a53e8a37c539f25
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.12
|