Global Leaderboard Aggregator (For kaggle competitions)

A dynamic web application that aggregates and displays real-time leaderboard data from multiple Kaggle competitions. Originally built with Django, now migrated to Flask for improved performance and simplicity.

🔄 Leaderboard Aggregator is now with Flask!

This project has been successfully migrated from Django to Flask framework, bringing several improvements:

Lighter Weight: Reduced dependencies and simpler architecture
Faster Response Time: Streamlined data processing pipeline
Easier Deployment: Simplified configuration and setup process
Better Resource Usage: More efficient memory management

✨ New Features

Since the migration, we've added several enhancements:

Real-time Competition Countdown: Dynamic timer showing competition status and remaining time
Animated UI Components: Smooth animations for leaderboard updates
Responsive Design: Mobile-friendly interface using Tailwind CSS
Visual Score Indicators: Progress bars showing relative performance
Auto-updating Rankings: Real-time score updates
Competition Status Tracking: Clear indicators for competition phases (upcoming/active/ended)

🚀 Quick Start

Prerequisites

Python 3.10+
pip
Kaggle API credentials

Installation

Clone the repository:

git clone git@github.com:yassermessahli/TrainIt-datathon-leaderboard.git
cd kaggle-leaderboard-aggregator

Create and activate a virtual environment:

python -m venv venv
.\venv\Scripts\activate

Install dependencies:

pip install -r requirements.txt

Configure your competition settings in config.py:

COMPETITION_CONFIG = {
    "competition_name": "Your Competition Name",
    "start_time": "2024-11-14T19:00:00+00:00",  # Competition start time
    "end_time": "2024-11-15T19:00:00+00:00",    # Competition end time
    "teams": [
        "team1",
        "team2",
        # Add your team names
    ],
    "competitions": [
        "competition1",
        "competition2",
        # Add your Kaggle competition IDs
    ],
    "weights": {
        "competition1": 0.5,
        "competition2": 0.5,
        # Add weights for each competition (must sum to 1)
    }
}

Run the application:

python .\app\app.py

Open your browser and navigate to http://localhost:5000

🔧 Configuration

Adding Teams

Add team names to the teams list in config.py. These should match exactly with the team names on Kaggle.

Adding Competitions

Add competition IDs to the competitions list
Add corresponding weights in the weights dictionary
Ensure weights sum to 1.0

Example:

"competitions": ["competition1", "competition2", "competition3"],
"weights": {
    "competition1": 0.4,
    "competition2": 0.3,
    "competition3": 0.3
}

📊 Features Explanation

Global Score Calculation

The global score for each team is calculated as:

Global Score = Σ (1 / Competition_ranking × Competition_Weight)

Real-time Updates

The leaderboard automatically updates to show:

Current rankings
Individual competition scores
Global aggregated scores
Competition status and remaining time

Visual Elements

Progress Bars: Show relative performance compared to top score
Rank Badges: Special styling for top 3 positions
Status Indicators: Show competition phase (upcoming/active/completed)
Countdown Timer: Real-time updates for competition duration

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Ldn26/dash-edited