A web app for actionable fantasy football advice using the Sleeper API and Boris Chen tiers.
sleeperPy is a Go + HTMX web application that lets you:
- Instantly analyze all your Sleeper fantasy football leagues by username
- See Boris Chen tiers for every player (starters, bench, IR, free agents)
- Get actionable upgrade suggestions (free agent upgrades, swap candidates, suboptimal starters)
- See win probability and opponent tiers for the current week
- Enjoy a clean, sortable, mobile-friendly UI with tabs, color coding, and shareable links
- Monitor usage and health with built-in Prometheus metrics
- Multi-league support: Enter your Sleeper username, see all your leagues at once
- Boris Chen tiers: Ranks from all FantasyPros experts, updated weekly
- FLEX/SUPERFLEX logic: Heuristically marks FLEX/SUPERFLEX slots in your lineup
- Free agent upgrades: Highlights top available free agents who are clear upgrades
- Actionable highlighting: Suboptimal starters, swap candidates, and more
- Win probability: Based on average tier vs. opponent
- Prometheus metrics:
/metricsendpoint for total visitors, teams, leagues, errors, and more - Configurable logging: Use
-log=info(default) or-log=debugfor verbose logs
go build -o sleeperpy
./sleeperpy -log=info
# or for debug logs:
./sleeperpy -log=debugThe app will start on port 8080 by default. Set a custom port with:
PORT=9090 ./sleeperpyThen visit http://localhost:8080 in your browser.
- Enter your Sleeper username on the homepage
- Instantly see all your leagues, tiers, and actionable advice
- Click tabs to view free agents by position, or share your team page with a link
sleeperPy includes a comprehensive test suite covering all features. See TESTING.md for detailed documentation.
# Run all tests
make test
# Generate visual HTML outputs for manual inspection
make test-visual
# Generate and auto-open visual tests in browser
make test-view
# Run tests with coverage report
make test-coverage
# Clean test artifacts
make test-clean- ✅ All scoring formats (PPR, Half-PPR, Standard)
- ✅ FLEX and SUPERFLEX logic
- ✅ Free agent recommendations
- ✅ Upgrade detection and swap suggestions
- ✅ IR player handling
- ✅ Win probability calculations
- ✅ Template rendering with visual outputs
Visual test outputs are saved to test_output/ - open test_output/index.html to see all rendered scenarios.
- Prometheus metrics are available at
/metrics - Metrics include: total visitors, lookups, leagues, teams, errors
- Logging level is controlled by the
-logflag
- Tiers powered by Boris Chen
- Built by @wbollock
If you like this project, please ⭐ the repo!