Skip to content

arhamshah/Cowin_Vaccine_Availability_Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logo of Program
Cowin Vaccine Availability Notifier Telegram Bot

A bot that notifies the available vaccines at given district in realtime.

made with python built with love

IntroductionRequirementsInstallationWorking of BotHow it WorksThanks ❤


Introduction

This Project uses an API from Cowin Portal to find available doses of vaccines and automatically notifies the users via Telegram Chat.

Requirements

  • Python 3.3+
  • macOs or Linux or Windows

Installation

Building the source code

1. Clone the repository

git clone https://github.com/arhamshah/Cowin_Vaccine_Availability_Bot.git
cd Cowin_Vaccine_Availability_Bot

2. Create Virtual Environment

python -m venv c:\path\to\myenv

3. Download & Install all the Dependencies

pip install -r requirements.txt

Working of Bot

Working of Project

How it Works

  • Data for upto 7 days is extracted from an API.
  • Iterating over data to check for available vaccine doses.
  • If any dose available then a message is sent via Telegram API to a specific channel.
  • The particular data which has been sent to telegram is cached for 1 hour to prevent multiple notifications.
  • Data from API is updated every 4 seconds.

Thanks

  • Government of India for providing open API to extract the data in real time.
  • Shout-out to developers & contributors of Requests, cachetools.

About

A Telegram Bot which notifies the user when a vaccine is available on CoWin Platform.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages