CoWIN Portal is used to self-register yourself for the Vaccination process in India. Here you can register yourself with your Phone Number and avail a slot from the available slots in various Vaccination Centres around the country.
VacCowin is a Python Script to find open slots for Vaccination in India based on your pincode (or multiple pincodes) or State and District. This script will recheck after every few minutes and as soon the slots open, inform you via Beeping sound & Desktop notification.
Since India has started the Vaccination Drive for those above 18 years of age, there is a very heavy rush and slots get booked soon. This script will come in handy for finding those slots as soon as they open.
The data is retrieved using the open public APIs at API Setu. It works on both Linux and Windows.
- Install Python
- Clone this repository...
git clone https://github.com/dhhruv/Vac-Cowin.git
- Install, create and activate virtual environment. For instance we create a virtual environment named 'venv'.
pip install virtualenv python -m virtualenv venv venv\Scripts\activate.bat
- Install dependencies
pip install -r requirements.txt
||Show the Help Message and exiting the program.|
||Pincode(s) to look for slots.|
||Age of the User(Default = 18).|
||Date to check Vaccination(Format = DD-MM-YYYY).|
||For a User Friendly Interface.|
||Interval in which to read Data from CoWin Website in Seconds. (Default = 300)|
||The State you want to search for.|
||The District you want to search for.|
1. Using Pincode(s):
- You can check the available slots by entering Pincode(s) using
-pspecified with age using
2. Using State and District:
- You can check the available slots by entering State using
-sand District using
-tspecified with age using
3. Using Wizard Mode(For Beginners):
- If you're a beginner then you can specify
-win the Terminal or directly run the Script to enter the Wizard Mode for Beginners.
python VacCowin.py -w
- Enter the Information asked to check the Available Slots.
So, stay tuned for further updates on GitHub:
Note:- Either Proceed through Pincode Method OR (State and District) Method for a reliable response.