github.com/cheran-senthil/TLE ↗

About cheran-senthil/TLE

TLE is a feature-rich Discord bot designed for competitive programmers, particularly those who participate on Codeforces. It provides problem and contest recommendations, displays user statistics and ratings, manages duels between users, and operates a starboard system for pinning popular messages in servers. The bot is controlled through a simple semicolon prefix and includes features like rating change tracking, contest announcements, and graph generation for visualization of competitive programming data.

The project is built in Python and uses Docker for easy deployment, with all dependencies containerized so users only need Docker 24 or later to run it. The bot connects to Codeforces APIs to pull live contest data and user information, and generates graphs that require Cairo and Pango libraries, which are pre-included in the Docker image. Users can configure the bot through environment variables for their Discord server's specific needs, including setting admin and moderator roles and specifying where error logs should be sent.

The repository is actively maintained and welcomes contributions from the open-source community, with code style managed through Ruff for linting and formatting. The bot is organized into modular components called "cogs" that handle different functionality areas, and the project includes a data folder that persists caches and downloaded assets between runs, making it practical for long-term deployment on Discord servers.