cowin-slot-tracker

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

cowin-slot-tracker

★ 27 Open GitHub ↗

Tracker to check the covid shot slot availability in India and send mobile alerts via Telegram Bot.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Cowin-Slot-Tracker
Tracker to check the covid vaccine slot availability in your district and send mobile notifications through Telegram.

## Requirements
Python 3.0+ or Docker must be installed in the local system. 
  - For Docker: Refer [docker documentation](https://docs.docker.com/engine/install/) to set it locally based on your machine specification.If you are a Windows user and wants to setup docker, follow this [video](https://youtu.be/_9AWYlt86B8)
  - If you cannot install Docker on your system, install Python by following this [link](https://www.tutorialsteacher.com/python/install-python)

## How to use?
There are two parts to this system
1. Pinging the public COWIN API to get district wise data and checking for availability, every 15 minutes.
2. Relaying this information to the user's mobile via Telegram Bot. 
    - For that, you need to create a bot. Follow this [tutorial](https://sendpulse.com/knowledge-base/chatbot/create-telegram-chatbot) to create a telegram bot. Refer the `How to Create a New Bot for Telegram` section. Note the `TOKEN`.
    - Now, open Telegram App and type `@Get_Channel_User_Telegram_ID_Bot`, and go to the chat. Type something and this should help you get your `Telegram ID`, which is your chat id. Note that as well.
    - After successfully completing the above steps, you are good to go.

Once all the above requirements are met, do the following
1. Git clone this repository(if you are techie enough), otherwise download the repository by clicking on `Download ZIP` under `Code`.
2. Open Terminal and change your directory to the folder you have just cloned/ downloaded. (Remember to extract the .zip file if you have downloaded it)
3. Modify `settings.json` with your settings.   
4. If you are going the Docker way, make sure Docker Desktop is running.
   - Run `docker build -t covin --rm .`
   - Run `docker run -it --name covin-schedule --rm covin`
   - If you want to change settings.json, rebuild the image and run Step 4
5. If you have Python already installed on your system,
   - Run `pip install -r requirements.txt`
   - Run `python covin_slot_tracker.py` 
8. If there is a slot available in the district id or pincode you have provided, you will receive an SMS on your phone.

#### Example Response
You can either use `pincode` or `districtId`.

Sample settings.json with `pincode`
```
{
  "pincode": "695013",
  "authToken": "1602################",
  "chatId" : "71############",
  "userAge": "45"
}
```

Sample settings.json with `districtId`
```
{
  "districtId": "391",
  "authToken": "1602################",
  "chatId" : "71############",
  "userAge": "45"
}
```

Response
```
Slots Available at 16 places.
SAKUR RH 2, Samsherpur RH, NIRAMAY HOSPITAL, Rahata RH, Chichondi Patil RH, Sakur RH, WAMBORI RH 2, 
Wambori RH, JAMKHED RH 2, Topkhana HP, Rajur RH, SHRIRAMPUR RH 2, CHICHONDI PATIL RH 2, TAKALI DHOKESHWAR RH 2, 
RAJUR RH 2, SAMSHERPUR RH 2

Here 391 is the district id for Ahmednagar, Maharashtra
```

#### Sample District Codes in Kerala
- 301: Alappuzha
- 307: Ernakulam
- 306: Idukki
- 297: Kannur
- 295: Kasaragod
- 298: Kollam
- 304: Kottayam
- 305: Kozhikode
- 302: Malappuram
- 308: Palakkad
- 300: Pathanamthitta
- 296: Thiruvananthapuram
- 303: Thrissur
- 299: Wayanad

#### Other States
To find District ID for other states:

Got to [Cowin Portal](https://www.cowin.gov.in/home) in the browser
- Open Network tab in browser
- Search for vaccine availabilty in portal
- Check Network tab for requests
- Find district_id property value from the requests

cowin-slot-tracker

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README