Gurkbot

The official bot for the Gurkult — an open source community with the aim of bringing people together.

Contribute

If you want to contribute, report a problem, add or suggest a new fix or feature, you can open a new issue. The issue should be accepted and discussed before starting to work on the feature. See Dev Installation to know how to start working on said feature.

Discord Setup

To get a token, go to Discord Developer Portal. Create an application and add a bot.

Dev Installation

1. Clone the repository:

• Traditional way: git clone https://github.com/gurkult/gurkbot.git or git clone [email protected]:gurkult/gurkbot.git.

• Using Github CLI: gh repo clone gurkult/gurkbot.

Then navigate to the directory cd gurkbot/

2. Create a new branch by git checkout -b <name of new local branch> main or git switch -c <name of new local branch> main. Make sure the new branch name is related to the feature or the fix you have in mind.

Environment variable setup

Create a .env file in the project root folder. Copy the contents from .env-example file into your .env file and fill up the fields with your bot token and server details.

Docker setup (recommended)

1. Pre-requisites

   • Docker
   • Docker Compose

2. Running and stopping the project

   # Build image and start project
   # This will start both the Postgres database and the bot.
   # Running this the first time will build the image.
   docker-compose up --build
   
   # Start/create the postgres database and the bot containers.
   docker-compose up
   
   # Use -d flag for detached mode
   # This will free the terminal for other uses.
   docker-compose up -d
   
   # Stop project
   # Use ctrl+C if not in detached mode
   docker-compose stop
   
   # Stop and remove containers.
   docker-compose down
   
   # Use -v or --volumes flag to remove volumes
   docker-compose down --volumes
   
   # Alternativily, `docker-compose` can be
   # replaced with `docker compose` (without the hyphen).
   

3. Running only database with docker

   docker-compose up postgres
   

4. Running only bot with docker

   docker-compose up gurkbot --no-deps
   

Running manually (without docker)

1. Prerequisites

   • Python 3.9
   • Poetry
   • Postgres database
     • Download

2. Database setup

   • Open terminal/cmd and enter psql

   psql -U postgres -d postgres
   

   • Create user and database

   CREATE USER gurkbotdb WITH SUPERUSER PASSWORD 'gurkbotdb';
   CREATE DATABASE gurkbot WITH OWNER gurkbotdb;
   

3. Add DATABASE_URL variable to .env file.

   DATABASE_URL = postgres://gurkbotdb:gurkbotdb@localhost:5432/gurkbot
   

   About the URL

   • format: postgres://<username>:<password>@<host>:<port>/<database>
   • If you have changed any of the parameters such has port, username, password or database during installation or in psql, reflect those changes in the DATABASE_URL.
   • The host will be localhost unless you want to connect to a database which is not hosted on your machine.

4. Command to run the bot: poetry run task bot

5. Commands to remember:

   # Installs the pre-commit git hook.
   poetry run task precommit
   
   # Formats the project with black.
   poetry run task format
   
   # Runs pre-commit across the project, formatting and linting files.
   poetry run task lint
   
   # Runs the discord bot.
   poetry run task bot