Competitive sports league packaged into a Discord bot. Compete with your friends, log the matches, and climb the ELO leaderboard. Any competitive activity where you score against your opponent is compatible with this bot.
You can run this bot locally on your device or through a bot hosting service.
To host locally, download the files and set up your Python installation with the labelled requirements. For more details, check startup-help.txt.
For hosting service, upload the files and invite the bot to your discord server.
/match - Log matches with @User1 and User2. Score is not required to log but recommended for the best competitive sports experience.
/leaderboard - View the top ranking players in your server
/history - View a player's previous 10 matches and an ELO graph displaying the trend.
This repo is actively maintained. More features are coming, with our own API and website coming to make it easier to bring a sports league to you. Report bugs at Issues.
Local League (formerly known as ELOBot) began because of a sudden table tennis obsession in the summer of 2025. We wanted to compete with each other and track our growth, rivalries, and the best. We created this bot to house our entire competitive league within our community.