thesuhas / pesu-academy-bot

PESU Academy Discord Bot built for PESsants and PESts of PES University

PESU Academy Bot

PESU Academy Discord Bot built for PESsants and PESts of PES University

You can add the bot to your Discord Server using this link. Once the bot has joined your server, please carry out the setup instructions posted by the bot.

What can PESU Academy Bot do?

1. It periodically fetches PESU announcements and notifies you immediately (thus eliminating any reason to open PESU Academy)
2. It is connected to a student database, and allows you to perform a query based lookup to search
3. It updates you about Instagram posts made by clubs
4. It also follows PES social media handles - Instagram and Reddit
5. It contains two URL shortners - long.rip by Adarsh Shetty and redirector by me
6. You can also execute Python code!
7. It features a meme-generator - SaaS and an English Dictionary

...and more.

Execute pes.help after adding the bot to your server to check out all the features.

How to run PESU Academy Bot?

1. Clone the repository

git clone [e-mail]:aditeyabaral/pesu-academy-bot.git

2. Create a separate virtual environment and install the dependencies. You can use virtualenv -- simple to setup and use.

cd pesu-academy-bot
virtualenv bot
source bot/bin/activate
pip3 install -r requirements.txt

3. Setup the following environment variables in a .env

ARONYA_ID=
BARAL_ID=
CHANNEL_BOT_LOGS=
BOT_ID=
BOT_TOKEN=
BOT_INVITE="https://discord.com/api/oauth2/authorize?client_id=847138055978614845&permissions=2148006976&scope=bot%20applications.commands"
BOT_GITHUB="https://github.com/HackerSpace-PESU/pesu-academy-bot"
CHROMEDRIVER_PATH=
GOOGLE_CHROME_BIN=
PESU_DATABASE_URL=
SERVER_CHANNEL_DATABASE_URL=
PESU_SRN=
PESU_PWD=
REDDIT_SECRET_TOKEN=
REDDIT_PERSONAL_USE_TOKEN=
REDDIT_USER_AGENT=

4. Run the bot using the following command

python3 src/bot.py

How to contribute to PESU Academy Bot?

1. Fork this repository ​
2. Create a new branch called username-beta ​
3. Make your changes and create a pull request with the following information in the request message:
   • The functionality you wish to change/add | What did you change/add
   • Screenshots of the feature working at your end ​
4. Send a review request to aditeyabaral or abaksy ​
5. Wait for approval for reviewers. Your PR may be directly accepted or requested for further changes

Important: Under no circumstances is anyone allowed to merge to the main branch.

Maintainers

Contact any of us for any support.

Aditeya Baral
Aronya Baksy