wtf is kosmos-vize-bot-v2?

Kosmos Visa Bot v2 is a Python bot that watches the Kosmos visa appointment booking system for newly opened appointment slots and sends alerts through Telegram. Instead of a person refreshing the booking website by hand, the bot checks automatically and only reports dates that were not available the last time it looked. The bot handles some of the messier parts of talking to the Kosmos system itself. Kosmos's API responses are encrypted with AES, so the bot decrypts them automatically. Logging in can be done two ways: by receiving an SMS code and replying to the bot with it, or by copying a JWT token directly out of your browser's local storage and sending it to the bot with a command. The bot also tracks when that login token is about to expire and asks you, through Telegram, to renew it before it stops working. It checks appointment availability up to 60 days ahead and can track both standard and VIP appointment types at the same time. If the visa system returns a rate limit error, the bot automatically waits before trying again rather than hammering the server. There is also an Apple Shortcut included so an SMS code arriving on an iPhone can be forwarded straight to the Telegram bot without retyping it. To use it, you edit a handful of settings directly in the bot's code, such as your Telegram bot token, the chat IDs that should receive notifications, applicant details, and how often to check. It requires Python 3.12 or newer plus two small libraries, and can be run directly with Python or through Docker for easier deployment. The project is released under the MIT license.