Skip to content

A self hosted, code centered, generic discord bot for your server.

License

Notifications You must be signed in to change notification settings

realendie/Saintly-Bot

Repository files navigation

Saintly Bot

A self hosted, code centered, generic discord bot for your server. Saintly Bot is made as a solution to expensive and propritary discord bots that make you pay for basic features.

Modules

Saintly Bot has some basic modules that every sever would need. Some include:

  • Moderation Commands (kick/ban/logging)
  • Welcome messages

Installation

There are two simple ways to host Saintly Bot for your self.

Requirements

  • Python >= 3.13
  • Requirements listed in requirements.txt
  • A Discord account

Discord Developer Setup

Follow the steps listed here to setup your discord bot: Create a Discord Bot and Add Permissions

Local Hosting

To host Saintly Bot locally via your terminal follow these steps:

  1. Clone the repository: git clone https://github.com/realendie/Saintly-Bot.git
  2. CD into the directory: cd Saintly-Bot/
  3. Install requirements:
  4. Create virtual environment: python3 -m venv .venv
  5. Activate virtual environment: source .venv/bin/activate
  6. Upgrade PIP: pip install --upgrade pip
  7. Install Python packages: pip install -r ./requirements.txt
  8. Fill in your servers information in saintly_bot.py
  9. Set your bot token to an evironment variable named SAINTLY_BOT_TOKEN (Method depends on your OS)
  10. Run the bot: python3 saintly_bot.py

Docker Hosting

  1. Clone the repository: git clone https://github.com/realendie/Saintly-Bot.git
  2. CD into the directory: cd Saintly-Bot/
  3. Make a new file named .env, inside it put:
SAINTLY_BOT_TOKEN = "your_bot_token"
  1. Start the docker container docker-compose up -d

About

A self hosted, code centered, generic discord bot for your server.

Resources

License

Stars

Watchers

Forks