Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Flyingbacen/Discord-rawrbot/llms.txt

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

You can get Rawrbot running locally with Python 3.10+ and a Discord bot token in just a few steps. The entire setup — from cloning the repository to seeing the bot come online — takes under five minutes once you have your credentials ready.
1

Clone the repository

Clone the Rawrbot repository from GitHub and change into the project directory:
git clone https://github.com/Flyingbacen/Discord-rawrbot.git && cd Discord-rawrbot
2

Install dependencies

Install all required Python packages using pip:
pip install -r requirements.txt
This installs the three direct dependencies:
  • discord.py — the Discord API library and app_commands framework
  • aiohttp — async HTTP client for external API requests
  • translate — translation library used by the /translate command
3

Create your config file

Copy config_EXAMPLE.json to config.json in the project root and fill in your credentials:
cp config_EXAMPLE.json config.json
Edit config.json to match the following structure:
{
  "token": "YOUR_BOT_TOKEN_HERE",
  "spotify": {
    "spotifyClientID": "YOUR_SPOTIFY_CLIENT_ID",
    "spotifyClientSecret": "YOUR_SPOTIFY_CLIENT_SECRET"
  },
  "webhook": "YOUR_DISCORD_WEBHOOK_URL"
}
  • The token field is the only value required to start the bot.
  • The spotify credentials are only needed if you want the /searchspotify command to function.
  • The webhook URL is only needed for the /upload command when invoked in its configured channel.
See the Configuration page for full details on obtaining each value.
4

Run the bot

Start Rawrbot with:
python main.py
On a successful launch you will see the following printed to the console:
Ready!
The bot is now online, has loaded all four cogs (general, moderation, music, utility), and is listening for slash commands.
The bot is initialised with a command prefix of ! in main.py, but this prefix is intentionally unused. All user-facing interactions are Discord slash commands registered through app_commands.
Never commit your config.json to version control — it contains your bot token, which grants full control of the bot account. The repository includes a .gitignore; make sure config.json is covered by it before making any commits.

​
Verifying the Bot is Online

Once you see Ready! in the console, switch to Discord and confirm the bot is working:
  1. The bot will appear in your server’s member list with an idle status and a “Listening to your commands” activity — both set in the on_ready event handler.
  2. Open any channel the bot has access to and type /ping. If Rawrbot responds with a Pong! message showing its latency in milliseconds, the setup is complete and all systems are operational.
If the bot does not appear online or /ping returns no response, double-check that:
  • Your config.json contains a valid bot token.
  • The bot has been invited to your server with the correct permissions.
  • The Message Content Intent is enabled in the Discord Developer Portal under your bot’s settings.

Build docs developers (and LLMs) love

Get started for freeTalk to us