HoloUA/Discord
HoloUA/Discord
1
0
Fork 0
Code Issues Pull Requests Releases 5 Activity
Bot that handles welcome messages and does utility stuff
83 Commits 2 Branches 5 Tags 326 KiB
Python 98.6%
Dockerfile 1.4%
09da774f26
Go to file
Profitroll 09da774f26 Merge pull request 'Update dependency libbot to v4.0.1' (#21) from renovate/libbot-4.x into dev 
Reviewed-on: #21
2024-12-29 18:55:38 +02:00
classes WIP: Database migrations 2024-12-27 22:43:40 +01:00
cogs WIP: Database migrations 2024-12-27 22:43:40 +01:00
enums Improved type-hinting and overall sanity checks implemented. 2024-12-16 20:34:37 +01:00
errors Improved type-hinting and overall sanity checks implemented. 2024-12-16 20:34:37 +01:00
locale Closes #2 2024-06-23 12:05:03 +02:00
migrations Closes #17; Fixed migrations 2024-12-27 23:00:27 +01:00
modules WIP: Database migrations 2024-12-27 22:43:40 +01:00
validation WIP: Database migrations 2024-12-27 22:43:40 +01:00
.dockerignore Added experimental Docker instructions 2024-12-17 22:29:03 +01:00
.gitignore Added tmp to ignore 2023-05-06 17:51:27 +02:00
.renovaterc Initial commit 2023-05-02 15:46:15 +02:00
config_example.json WIP: Database migrations 2024-12-27 22:43:40 +01:00
Dockerfile WIP: Database migrations 2024-12-27 22:43:40 +01:00
LICENSE Initial commit 2023-05-01 15:59:20 +03:00
main.py Closes #17; Fixed migrations 2024-12-27 23:00:27 +01:00
README.md WIP: Database migrations 2024-12-27 22:43:40 +01:00
requirements.txt Removed now unused typing-extensions 2024-12-29 17:54:40 +01:00

README.md

HoloBot Discord

Small Discord bot made on Py-Cord

License: GPL Code style: black

Installation from release

  1. Install MongoDB using the official installation manual
  2. Install Python 3.11+
  3. Download the latest release's archive
  4. Extract the archive
  5. Navigate to the extracted folder and subfolder Discord in it
  6. Create a virtual environment:
    python -m venv .venv or virtualenv .venv
  7. Activate the virtual environment:
    Windows: .venv\Scripts\activate.bat
    Linux/macOS: .venv/bin/activate
  8. Install the dependencies:
    python -m pip install -r requirements.txt
  9. Run the bot with python main.py after completing the configuration

Installation with Git

  1. Install MongoDB using the official installation manual
  2. Install Python 3.11+
  3. Clone the repository:
    git clone https://git.end-play.xyz/HoloUA/Discord.git
  4. cd Discord
  5. Create a virtual environment:
    python -m venv .venv or virtualenv .venv
  6. Activate the virtual environment:
    Windows: .venv\Scripts\activate.bat
    Linux/macOS: .venv/bin/activate
  7. Install the dependencies:
    python -m pip install -r requirements.txt
  8. Run the bot with python main.py after completing the configuration

Upgrading with Git

  1. Go to the bot's directory
  2. git pull
  3. Activate the virtual environment:
    Windows: .venv\Scripts\activate.bat
    Linux/macOS: .venv/bin/activate
  4. Update the dependencies:
    python -m pip install -r requirements.txt
  5. First start after the upgrade must initiate the migration:
    python main.py --migrate
  6. Now the bot is up to date and the next run will not require --migrate anymore

Configuration

There's a file config_example.json which contains default configuration and should be used as a base config.

Copy this file to config.json and open it with any text editor of your liking.

Modify the newly created configuration file to fit your needs.

Mandatory keys to modify:

  • guild
  • bot.owner
  • bot.bot_token
  • database.*
  • categories.*
  • channels.*
  • roles.*

After all of that you're good to go! Happy using :)

Docker [Experimental]

As an experiment, Docker deployment option has been added.

Building the image

  1. git clone https://git.end-play.xyz/HoloUA/Discord.git
  2. cd Discord
  3. docker build -t holoua-discord .

Starting the bot

  1. Install MongoDB using the official installation manual
  2. Download the configuration example file and store it somewhere you would like your bot to access it
  3. Complete the configuration step for this file
  4. docker run -d -v /path/to/config.json:/app/config.json holoua-discord