Skip to content

Repository files navigation

🦅 @SRHXtra Zero-API Command Center (V2.0)

Python 3.9+ Streamlit Pandas License: MIT

@SRHXtra is an enterprise-grade, local-first sports data operations platform tracking 74 players across all 4 Sunrisers global cricket franchises (Sunrisers Hyderabad IPL, Sunrisers Eastern Cape SA20, Sunrisers Leeds Men, Sunrisers Leeds Women).


🌟 Key Features

  • 📊 Dynamic Master Roster Engine: Automatically tracks 74 players from squadofsunrisers.xlsx using regex word-boundary matching with zero false positives.
  • 🗓️ 30-Day Chronological IST Schedule: Complete fixture calendar sorted strictly in Indian Standard Time (IST) with live countdown timers.
  • 📰 16-Source Reconnaissance Engine: Automated scraper polling 16 top-tier cricket outlets (ESPNcricinfo, Cricbuzz, BBC Sport, Sky Sports, Wisden, etc.) with exponential backoff retries.
  • 🎨 Pillow Graphic Studio: Generates 16:9 Twitter stat graphics locally with smart templates (Century, Fifty, 5-Wickets, Bowling milestones).
  • 💎 Glassmorphism Streamlit Dashboard: Customized with Google Fonts (Outfit & Inter), dark mode aesthetics, and cross-device mobile responsiveness.

📁 Repository Architecture

Tracker/
├── app.py                      # Main Streamlit Command Center UI
├── squadofsunrisers.xlsx       # Master Excel Squad Roster (74 Players)
├── scrapers/                   # 16-Source Cricket Media Scraping Engine
├── database/                   # SQLite / Local Cache Persistence Layer
├── utils/                      # IST Date Formatter & Graphic Rendering Helpers
├── generated/                  # Generated 16:9 Twitter Stat Cards
├── requirements.txt            # Python Dependencies Manifest
└── tests/                      # Pytest Test Suite

🚀 Quick Start Guide

Prerequisites

  • Python: v3.9 or higher

1. Installation

git clone https://github.com/Snohith/srhtrack.git
cd srhtrack
pip install -r requirements.txt

2. Launching Command Center

streamlit run app.py

Access the dashboard at http://localhost:8501.


📄 License

Distributed under the MIT License. See LICENSE for details.


Maintained by Chiluveru Snohith

About

Local-first sports data operations platform & graphic card generator for Sunrisers global cricket franchises.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages