Punarjani is a project by us students of CUSAT made as part of the BHF competition conducted by TinkerHub. Punarjani aims to democratize the vaccination process. We believe that everyone must get equal opportunity and equal care when it comes to critical sectors like health and education. We may not be able to solve the vaccine shortage but we can definitely be part of the solution.
We made a Discord bot, our dear Mr. PJ. Mr. PJ integrates Cowin public API directly into your discord server. Long page load times and frustrating wait for OTP are now over. Mr. PJ will update you hourly ( if you prefer ) about vaccine availability in your district tailored to your details like age and which dose you need.
- Simple UI/UX
- Mr. PJ might be a bot, but it was built with humans in mind so you are assured a smooth learning curve.
- Hourly Notification
- Now you don't even have to check, you will be updated every hour automatically.
- Manual Slot Checking
- Just send !slot "some date" and Mr. PJ got you covered.
- Command Prediction
- With Mr. PJ typos or half spelled commands are not a problem. Mr. PJ will suggest you the most similar command automagically!
- Free Fore Ever
- Yes forever! That is not until a certain period or with a specific cap to the how much you can use. It is truly unlimited.
- Fully Opensource
- Works on any OS
- Anywhere you can install Discord Mr. PJ will be there for you.
- Unlimited Number of Device Support
- Can get updates on any number of devices simultaneously.
Our bot Mr. PJ follows a chatbot-like scheme. You can tell him to do what you want by using commands. Our commands are single words prepended with ! Exciting right !!
Mr. PJ is banned from chatting in channels other than DM to protect your privacy. Help and info commands should still work everywhere.
- !help This is the most basic command. It tells you how other commands work just in case you find it difficult.
- !register As the name suggests this command lets you register an account. Just send !register <your_age>
- !slots Now as you have told us all the details and completed the registration you can use the !slots command to see slots available for you. The format is !slots <a_date> or just !slots .
- !edit Just noticed you did something silly during the register don't worry you can edit everything you said. Just send !edit and select what you want to change from the menu that pops up.
- !profile So you have edited your details and now want to see how you look, just send !profile and Mr. PJ will tell you about yourself!!
- !info This must be the last command you might want to run, but still, it is there if you want to know some details about Mr. PJ
Check out our website for a detailed walk-through, or see this video for a glance.
Our Team ID of Build From Home is BFH/recMwpT0ZE1CPdRPX/2021
| Library | Version | Remark |
|---|---|---|
| axios | ^0.21.1 | |
| discord.js | ^12.5.3 | |
| firebase-admin | ^9.8.0 | |
| node-cache | ^5.1.2 | |
| dotenv | ^9.0.2 | Dev |
| eslint | ^7.26.0 | Dev |
| nodemon | ^2.0.7 | Dev |
This might be easier than adding Mr. PJ to your discord but still here are the steps :
You need to clone our repo to your local machine or use something like GitPod.
git clone https://github.com/rohittp0/Punarjani.git
This is the usual npm stuff. npm install
Go to Dicord and create a discord bot. Copy the bot Token to a .env file in the format,
BOT_TOKEN=your_token
Go to Firebase and create a project. Download the service account.json and convert it to a JSON string. Now add the JSON string to the .env file in the format,
FIREBASE_KEY=json_string
And that's it. You are all set to test drive your version of Mr. PJ. You can call it PJ Junior
You can run this project locally using
npm run watch
or you can go the extra mile to run it with
node -r dotenv/config src/index.js
If you want to host your bot there is an extensive how-to guide on Heroku just follow it and if you get stuck just open an issue here.