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. Traditional way: git clone https://github.com/gurkult/gurkbot.git or git clone git@github.com: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.

3. Create a .env file with following contents:

   TOKEN = <Your token> # See Discord Setup above
   PREFIX = "!" # the prefix the bot should use, will default to "!" if this is not present
   

4. Install pipenv: pip install pipenv and run the following:

   # This will install the development and project dependencies.
   pipenv sync --dev
   
   # This will install the pre-commit hooks.
   pipenv run precommit
   
   # Optionally: run pre-commit hooks to initialize them.
   # You can start working on the feature after this.
   pipenv run pre-commit run --all-files
   
   # Run the bot
   pipenv run start
   

5. Lint and format your code properly (use black or flake8) or pipenv run lint, and push changes git push -u origin <name of new remote branch>