A telegram bot for getting answers to a lot of frequently asked questions for freshers coming to IIT Mandi.
- Flask
- ngrok
- python-telegram-bot
- Dialogflow
- APIs: Firebase, Google Maps, Nominatim, Stack Exchange
- Clone the repository.
- Create an evironment using
venv. - Install required dependencies using pip from
requirements.txt. - Get a telegram bot token from the BotFather bot at telegram.
- Setup a proxy server using ngrok and set the port number to be the same as chosen in your Flask server(only few ports are accepted by telegram eg-8443). The command for that is:
./ngrok http 8443. - Run the ngrok server and copy the forwarding URL of the form https://randomseq.ngrok.io/. This will be the URL for our webhook.
- Set the bot token and URL for webhook as environment variables in the .env file as follows:
TOKEN=<YOUR_TOKEN>andurl_for_webhook=<URL>. - Run the bot.py file. The bot will read and print logs of information like intents detected and text extracted from the voice message.
Humanoid can answer various queries of freshers related to:
- hostels, mess
- academics, and placements
- clubs, societies, and fests
- fees,labs
..and a lot of other amazing things at IIT Mandi. Also, it provides some additional features like:
- Speech recognition for interaction.
- Providing documents and other resources related to admission and branch curriculum.
- Suggesting ideal travelling routes to the campus from the user's location.
- Searching for posts on stackoverflow's websites for doubts related to programming.
Clone the repo and feel free to send any Pull Requests that you feel to be constructive Guidelines