Formula 1 Bot

Discord bot that shows stats and information about the current F1 season: drivers, constructors, races, qualifying, circuits and calendar. Add to your server

✨ Features

• Driver and constructor championship standings, refreshed on every command
• Result of the last race and the last qualifying session
• List of drivers, constructors, circuits and calendar for the current season
• Slash commands and prefix commands ($) working side by side

📦 Dependencies

The Dependencies and Installing sections below are for developers who want to run or contribute to the bot's code. If you just want to use the bot on your server, click Add to your server above — no setup needed.

Dependency	What it's for
Python 3.10+	Run the project
A Discord bot application	Discord Developer Portal

Python libraries (installed via requirements.txt):

• discord.py: Discord API wrapper (slash commands, embeds)
• python-dotenv: loads configuration from .env
• requests: HTTP requests (F1 data via Jolpica-F1)

🚀 Installing

# 1. Clone the repository
git clone https://github.com/MaykeESA/f1-bot.git
cd f1-bot

# 2. Create the virtual environment and install dependencies
python -m venv venv
source venv/bin/activate          # Windows: venv\Scripts\activate
pip install -r requirements.txt

# 3. Configure the environment
cp .env.example .env

Fill in .env with your bot's token:

• TOKEN: your bot's token, generated on the Discord Developer Portal (required).
• GUILD_ID: guild used for instant sync of slash commands during development (only used if SYNC_GLOBAL isn't true).
• SYNC_GLOBAL: true syncs commands globally (propagation takes up to 1h); otherwise syncs only to GUILD_ID, which is instant.

python main.py

💻 Commands

/driver-standings, $driver-standings

Shows the current drivers' championship standings.

/constructor-standings, $constructor-standings

Shows the current constructors' championship standings.

/race, $race

Shows the results of the last race.

/qualifying, $qualifying

Shows the results of the last qualifying session.

/constructors, $constructors

Shows all constructors in the current season.

/drivers, $drivers

Shows all drivers in the current season.

/circuits, $circuits

Shows all circuits in the current season.

/calendar, $calendar

Shows the current season's calendar.

Data provided by Jolpica-F1, the open-source successor to the Ergast API (shut down in 2024).

note: all these commands are relative to the current year and the last race that happened; if there hasn't been a race yet this year, it shows data from the previous year.

📄 Copyright and license

Code and documentation copyright 2026 Mayke Erick. Code under the MIT License.