A minimal and open-source discord.py boilerplate for kick-starting bot projects.

I spend a lot of time developing bots for different communities on discord, and I find myself constantly rewriting the same basic boilerplate for each project. After searching for an existing template with no luck, I decided to write my own that’ll suit any type of application.

So this repository includes an all inclusive bare-bones boilerplate for discord.py bot development that you can use as a basic skeleton for your next project.


  • Python 3.6 +
  • The pip package management tool.


Slash commands can take some time to register on guilds (usually an hour or two.) If you’d like to test a slash command beforehand, use the guild_ids in the command decorator to register them instantly.

 description="Command description",
 guild_ids=[GUILD_ID1, GUILD_ID2] # The ID(s) of the guild(s) you wish to test.


  1. Clone the repository. git clone https://github.com/tarranprior/discord_bot_template.py.
  2. Navigate to the project folder. cd "discord_bot_template.py".
  3. Install the dependencies. pip install -r requirements.txt.
  4. Create an application at Discord Developer Portal. Build a bot, and copy the token.
  5. Invite the bot to your server/guild.
  6. Update the values in configuration
  7. Run the bot. python discord_bot.py.
  8. Start developing!


  1. Update the values in SAMPLE.env and rename to .env.

  2. Optional: Update the values in config.json.

    ” “status”: “discord_bot_template.py” }”>

    	"prefix": ">"
    	"status": "discord_bot_template.py"


This bot includes a handful of features that are useful for all development projects. For example, developer.py commands.

  • config – Update the bot’s configuration (prefix, status etc.)
  • purge – Deletes n messages.


This project is licensed under the MIT License – see the LICENSE file for details.


View Github