https://github.com/brendanddev/fantasy-analyzer
Fantasy Analyzer is an unofficial Python wrapper for the Sleeper fantasy football API.
https://github.com/brendanddev/fantasy-analyzer
Last synced: 8 months ago
JSON representation
Fantasy Analyzer is an unofficial Python wrapper for the Sleeper fantasy football API.
- Host: GitHub
- URL: https://github.com/brendanddev/fantasy-analyzer
- Owner: brendanddev
- License: mit
- Created: 2025-08-24T21:43:25.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-09T13:34:22.000Z (9 months ago)
- Last Synced: 2025-09-09T15:40:38.966Z (9 months ago)
- Language: Python
- Homepage:
- Size: 48.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Fantasy Analyzer
Fantasy Analyzer is an **unofficial Python wrapper** for the Sleeper fantasy football API.
It allows you to easily fetch user, league, roster, and matchup data for analysis and tracking.
> ⚠️ Disclaimer: This project is **not affiliated with Sleeper**.
> It uses Sleeper’s **read-only public API**, documented here: [https://docs.sleeper.com/](https://docs.sleeper.com/).
---
## Overview
Fantasy Analyzer helps fantasy football managers and analysts to:
- Fetch and inspect user profiles, including display names and avatars.
- Explore league details (status, season, total rosters, etc.).
- View team rosters with player names.
- Track trending NFL players over time (adds, drops, trades).
- Use a clean **Streamlit dashboard** for interactive exploration.
The library is split into:
- `client.py` → Core API wrapper for Sleeper endpoints.
- `utils.py` → CLI-friendly functions (`print_user_info`, `print_league_info`, etc.).
- `st_utils.py` → Streamlit helpers (`st_user_info`, `st_league_info`, `st_rosters`, `st_trending_players`).
- `dashboard.py` → Interactive Streamlit app with tabs and reactive updates.
---
## Features
- **User & League Data**
- Fetch user profiles and league details.
- **Roster & Player Analysis**
- View rosters, player names, positions, and NFL teams.
- Track top performers per week and by position.
- View trending players (adds, drops, trades) over custom timeframes.
- **Team Performance**
- Identify best-performing fantasy teams by weekly points.
- **Roster Composition Insights**
- Calculate the average number of players per position across all teams.
- **Interactive Dashboard**
- Streamlit-based with multiple tabs for top performers, trending players, team performance, and league overview.
---
## Installation
```bash
git clone https://github.com/brendanddev/fantasy-analyzer
cd fantasy-analyzer
pip install -r requirements.txt
```
---
## Quick Start
```python
from src.client import SleeperClient
from src.utils import print_user_info
client = SleeperClient()
# Optionally load local players JSON
# client.load_players("data/players.json")
print_user_info(client, "1234567890")
```
---
## Usage with Streamlit
Run the interactive dashboard:
```bash
streamlit run src/dashboard.py
```
Explore tabs for:
- Top Performers
- Trending Players
- Team Performance
- League Overview
---