A COVID-19 vaccine slot availability notifier.
Vacc Alert is a COVID-19 vaccine slot availability notifier for usage in India built using
- Python
- Co-WIN Public APIs (provided by Govt. of India)
- Twilio (a cloud communications platform)
Using this command line tool, people can input their preferences like state, district, preference of centres, age, choice of dose and phone number. The script will then periodically check the availability of slots in the centres of preference and notify the user in the phone number given. The user can then login to the cowin website and book his/her appointment.
The script has been designed in such a way that anyone with basic command line proficency can use it easily.
However, the user has to sign up for a trial account with Twilio and then verify their phone number to recieve messages. Users can also be notified with a missed call if needed.
Scroll down to read the installation steps or click the image below to watch the video tutorial.
- Easy Usage
- No need to waste your time reloading the website.
- Users will be alerted with a simple SMS
- Sign Up for Twilio here.
- Verify your email-id and phone number with Twilio.
- Obtain a trial number by clicking "Get a Trial Number"
- In the end, take note of your trial number, Account SID and Auth Token from your dashboard.
- Clone this repository or download ZIP and extract
- Open command prompt or terminal and get in to this folder.
cd VaccAlert
- Run
pip install -r requirements.txt - Edit file named "consts.py" and enter your Twilio Account SID, Auth token and trial number in the following format:
ACCOUNT_SID = "<Twilio Account SID>"
AUTH_TOKEN = "<Twilio Auth Token>"
FROM = "<Twilio trial number>"
- If you need to be notified by call, you can uncomment lines 149-153 of the file
main.py - You are ready to go!
- Open CMD/Terminal and run
py main.py - Enter the required details
- The script will run in the background and you can exit it anytime by pressing
Ctrl + C
- Sample SMS below:
