BDE Bot

Source code of the BDE Algo's Discord bot.

DISCLAIMER: This is NOT a library, but an implementation based on Pycord, suited for our needs.
We make it open-source because we are open to contributions !

Set up and run

Prerequisites

• uv for Python package management
• Python 3.11 or higher
• A Discord bot token (get one from Discord Developer Portal)

Docker Setup (Recommended)

The easiest way of setting up this bot is with Docker:

1. Clone the git repository onto your machine
2. cd into the cloned directory
3. Create a .env file in the root directory and add your Discord bot token:

   cp .env.example .env
   # Edit .env and set your DISCORD_TOKEN

4. Run with docker-compose:

   docker-compose up -d

Local Development Setup

1. Clone the git repository onto your machine
2. cd into the cloned directory
3. Install uv if you haven't already
4. Install dependencies:

   uv sync

5. Create a .env file with your Discord bot token:

   cp .env.example .env
   # Edit .env and set your DISCORD_TOKEN

6. Run the bot:

   uv run python main.py

For background execution, you might want to use tmux or screen to detach the script from your terminal.

Additional resources

To add your bot to a server, use this link: https://discord.com/api/oauth2/authorize?client_id=[id]

In this link, do not forget to replace [id] by your application ID, and paste this link in Discord (a wizard will ask you where you want to install it). You can tune its permissions and scopes here: https://discord.com/developers/applications/.

Usage

Documentation for the currently implemented commands is available in COMMANDS_USAGE.