DEV Community

loading...
Cover image for VacCoWIN - Book CoWIN Slots directly from your Terminal...

VacCoWIN - Book CoWIN Slots directly from your Terminal...

Dhruv Panchal
I am an undergrad student who is obsessed with the idea of improving himself and wants a platform to grow and excel.
・3 min read

Introduction

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.

About

VacCowin is a CLI based Python Script that can be used to perform tasks such as OTP Generation till Vaccination Slot Booking from Co-WIN Platform directly from your Terminal. This script rechecks after every few seconds and when the slots are available, it confirms the slot only after you enter the captcha shown on the screen.

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 booking those slots as soon as they open.

IMPORTANT: This is a Proof of Concept (POC) Project. I OR the Team do NOT endorse or condone, in any shape or form, automating any monitoring/booking tasks. It's only made for Educational Purposes. Use this at your own risk.

The data used is retrieved using the open APIs at API Setu. It works on both Linux and Windows.

GitHub logo dhhruv / Vac-Cowin

πŸ’‰ One Stop Solution for Booking Vaccination Slots available in the CoWIN Portal directly from your Terminal...

Getting Started

  1. Install Python
  2. Clone this repository...
git clone https://github.com/dhhruv/Vac-Cowin.git
Enter fullscreen mode Exit fullscreen mode

OR
Download the Zip and Extract the content.

  1. 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
Enter fullscreen mode Exit fullscreen mode
  1. Install dependencies
cd Vac-Cowin
pip install -r requirements.txt
Enter fullscreen mode Exit fullscreen mode

GitHub logo dhhruv / Vac-Cowin

πŸ’‰ One Stop Solution for Booking Vaccination Slots available in the CoWIN Portal directly from your Terminal...

Usage

Will be Updated after Testing...

Check out yourself and send me a Screenshot if found useful...

Contributing

Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Team Members:

  1. Dhruv Panchal
  2. Urveshkumar Patel
  3. Nirja Desai

GitHub logo dhhruv / Vac-Cowin

πŸ’‰ One Stop Solution for Booking Vaccination Slots available in the CoWIN Portal directly from your Terminal...

Important:

  • This is a Proof of Concept Project. I OR the Team do NOT endorse or condone, in any shape or form, automating any monitoring/booking tasks. It's only made for Educational Purposes. Use this at your own risk.
  • This Python Script CANNOT book slots automatically. It doesn't skip any of the steps that a User would have to take on the official portal. You will still have to enter the OTP and Captcha as you do in the CoWIN Portal.
  • Do NOT use unless all the beneficiaries selected are supposed to get the same Vaccine and Dose.
  • There is no option to Register a new Phone/Mobile or add beneficiaries for now. This can be used only after beneficiary has been added through the official Portal/App.
  • Be careful if you're choosing to use the auto-book feature. It will blindly select first available Vaccination Centre, Date (Both Sorted Ascending) and a RANDOM slot. I would not recommend using this feature unless and until it's crucial.
  • If you accidentally booked a slot you didn't want to then don’t worry. You can always log in to the CoWIN Portal and cancel/re-schedule that.
  • API Details (Do read the first paragraph): https://apisetu.gov.in/public/marketplace/api/cowin/cowin-public-v2

Discussion (0)