Installation Guide

1. Prequisites

• git.
• python at minimum version 3.12.
• An internet connection.
• A machine that just works.
• A Discord bot user.

2. How to self-host your own bot

• Fetch the code of the bot.

  git clone https://github.com/team-nameless/nameless-discord-bot

• Head to the directory where bootstrapper.py is located.

Tip

We provided a bare minimum to setup logging and run, but you can edit to your favor!

• Open the terminal and create a virtual environment directory.

  python -m venv .venv

  and activate it:

  • Linux/Unix: source .venv/bin/activate
  • Windows: .\venv\Scripts\Activate.ps1 or .\venv\Scripts\activate.bat

  at this point you should see (venv) at the start of your command prompts.

Note

You can use the global Python environment, but it is not recommended to do so.

• Install packages needed to run the bot: python install -U -r requirements_core.txt

  ⚠️ Do NOT install requirements_dev.txt unless you are a developer and wanting to contribute!

• You should see a NamelessConfig_example.py, first rename to NamelessConfig.py then open it, provide values as needed, like bot's token in TOKEN

  ℹ️ Please read the instructions provided in the file carefully!

• You should be able to run the bootstrapper.py file now: python bootstrapper.py

3. Further readings

• Can I add my own commands?
• Maintenance guides
• Troubleshooting