Skip to content

nikiljos/my-vaccinator

Repository files navigation

BFH Banner

myVaccinator

myVaccinator is a discord bot that alerts you about the available vaccination slots in your area every hour. Simply type !vaccine in a common server and get your vaccination slot the smart way.

Team members

  1. Nikhil Jose
  2. Midhun Mathew

Team Id

BFH/receEVi8kY4wfVJJy/2021

Link to product walkthrough

[link to video]

How it Works ?

When you type !vaccine, required details are collected conversationaly by the bot. It then stores this data to a mongoDB database and and sends you alerts on regular intervals as DM in discord. Vaccination slot details are fetched using the CoWin API. In order to overcome the rate limtations of the API the server caches the slot availability data every 10 minutes so that the API limit will never be exhausted. Embed video of project demo

Packages used

axios - v0.21.1
discord.js - v12.5.3
dotenv -v9.0.2
mongoose - v5.12.10
node-cron - v3.0.0

How to configure

In order to run the bot on your own Server and Database,

  • Clone the repo
  • Install required packages
  • Run the app using node bot.js

How to Use

In a common server type !vaccine to invoke the bot and start recieving alerts.
The bot is not open for public use as of now so it may not work properly in your discord server unless it is deployed in your own Server and Databases