Cowin Assist Telegram Bot
Check the bot here @cowinassistbot.
This is a simple Telegram bot to
- Check slots availability
- Get an alert when slots become available
Book an available slot
all this with a single click of button.
Note
On 6th May 2021, CoWin API added caching and rate limits. The public API data would be cached upto 30 minutes, so the alerts wouldn't be so instant in busy areas, which reduced this bot's functionality to being a nice UI for public CoWin site in Telegram.
Installation and Deployment
Following section helps you host the bot on your own servers.
Prerequisites
You need a bot account on Telegram. Use @BotFather to create one. If you are new to Telegram Bots, you may start from here Bots: An introduction for developers.
System Requirements
This bot is built and tested on Linux and Mac OS X. It should work on Windows machines as well, but I haven't tested it. Other requirements:
- Python 3 (version 3.8+)
- SQLite 3
Installation
Install the project requirements from requirements.txt:
$ pip install -r requirements.txt
Rename sample_secrets.py to secrets.py and fill it with appropriate details. Then you can run:
$ python main.py
2021-05-06 09:59:29,238 - __main__ - INFO - starting a bg worker - frequent_background_worker
2021-05-06 09:59:29,239 - __main__ - INFO - starting a bg worker - periodic_background_worker
2021-05-06 09:59:29,239 - apscheduler.scheduler - INFO - Scheduler started
You may use the supervisor.conf provided for deployment using Supervisord.
Development
Open an issue for any discussions and feel free to send a PR.
Disclaimer
Not affiliated with Ministry of Health and Family Welfare OR Government of India in any capacity.
License
Released under MIT License. Check LICENSE file more info.
244 Nov 30, 2022
1 Dec 10, 2021
4 Apr 2, 2022
16 Nov 9, 2022
31 Sep 30, 2022
43 Jun 11, 2022
5 May 10, 2021
5 Oct 6, 2022
9 Sep 20, 2021
27 Nov 12, 2022
6 Apr 28, 2022
7 Jul 31, 2021
8 Jun 16, 2021
30 Oct 7, 2022
10 Jun 11, 2022
560 Dec 19, 2022
5 Nov 26, 2021
2 Oct 11, 2022
605 Dec 14, 2022