Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/astrxnomo/discord-ticket-bot-py/llms.txt

Use this file to discover all available pages before exploring further.

Getting the bot running locally starts with pulling down the source code and installing the two Python packages it depends on. This guide walks you through cloning the repository, installing dependencies with pip, and verifying that everything is in place before you move on to configuration.

​
Requirements

Before you begin, make sure the following are available on your system:
  • Python 3.8 or higher — the bot uses async/await syntax and discord.py 2.0
  • pip — Python’s package installer, bundled with most Python distributions
  • git — used to clone the repository and to install discord_components directly from its GitHub source

​
Installation Steps

1

Clone the repository

Run the following commands to download the project and move into its directory:
git clone https://github.com/astrxnomo/discord-ticket-bot-py.git
cd discord-ticket-bot-py
2

Install dependencies

Install all required packages in one command using the provided req.txt file:
pip install -r req.txt
The contents of req.txt are:
git+https://github.com/kiki7000/discord.py-components
discord.py==2.0.0
This installs two packages:
  • discord.py 2.0.0 — the core Discord API wrapper the bot is built on.
  • discord_components — installed directly from its GitHub source via the git+ URL. This library provides the ComponentsBot, Button, Select, and SelectOption classes the bot uses to render interactive menus and buttons inside Discord.
3

Verify the installation

Confirm that both packages were installed correctly by running a quick import check:
python -c "import discord; from discord_components import ComponentsBot; print('OK')"
If the output is OK, your environment is ready. If you see an ImportError, revisit the previous step and ensure pip completed without errors.
It is strongly recommended to use a virtual environment to keep the bot’s dependencies isolated from other Python projects on your machine. Create and activate one before running pip install:
# Create the virtual environment
python -m venv venv

# Activate it — macOS / Linux
source venv/bin/activate

# Activate it — Windows
venv\Scripts\activate
Once activated, run pip install -r req.txt as normal. The packages will be installed only inside the virtual environment.
With installation complete, the next step is to register your bot application on the Discord Developer Portal.

Bot Registration

Create a Discord application, add a bot account, and generate your bot token.

Build docs developers (and LLMs) love

Get started for freeTalk to us