TasteIt

A Telegram bot to look for a perfect place to have a meal.

View Demo · Documentation · Report Bug · Request Feature

📔 Table of Contents

• About the Project
  • Screenshots
  • Tech Stack
  • Features
  • Environment Variables
• Getting Started
  • Prerequisites
  • Installation
  • Usage
• Contact
• Acknowledgements

🌟 About the Project

TasteIt is a telegram bot which helps you and your friend to find the perfect place to have a meal, based on what you want to eat, your price preferences, your current location and so on. Furthermore you can explore the reviews and detailed information about the restaurant you are visualizing with few clicks and you can add places you liked to favorites lists.

The bot has been built in order to make it usable by a single person or in a group of people interacting together. Find out more by trying it directly.

📷 Screenshots

👾 Tech Stack

Functionalities

• Google Places
• Mapbox

Bot backbone

• Python
• python-telegram-bot

Database

• Sqlite3

🎯 Features

• /start - Starts the bot and shows a welcome message to the user;
• /help - Shows the list of available commands;
• /settings - Enables to modify some of the restaurant search settings; specifically it is possible to change the maximum number of meters we want to walk to reach the restaurant and the maximum number of meters we want to run across by car to reach the restaurant;
• /lang - Enables to change the language of the bot;
• /cerca - Starts the search for a restaurant;
• /preferiti - Shows the list of favorite restaurants either to the user or to the group;
• /annulla - Cancels the current operation;

🔑 Environment Variables

To run this project, you will need to add the following environment variables to your .env file

• TELEGRAM_KEY - The API key for the telegram bot;
• TELEGRAM_DEVELOPER_CHAT_ID_KEY - Id of the chat of the developer. Reported bugs through the bot will be sent to this chat;
• DEV_TELEGRAM_KEY - Optional, the API key for the telegram bot in development environment;
• GOOGLE_PLACES_KEY - The API key for accessing the google maps services;
• MAPBOX_KEY - The API key for accessing the mapbox services (routes calculations. Could be replaced by using an OpenStreetMap local server);

🧰 Getting Started

Prerequisites

This project works using Python and PIP packet manager. Make sure you have them installed on your machine.

  python --version
  pip --version

⚙️ Installation

You can deploy this project on your machine by following these steps:

  git clone https://github.com/paolopertino/TasteIt.git
  cd TasteIt
  pip install -r requirements.txt
  <CREATE THE .env FILE AND UPDATE WITH YOUR API KEYS>
  python main.py

👀 Usage

The chatbot can be used to look for places to have a meal. It has been developed to be used both in private and group chats.

The chatbot allows to look for restaurants and respective information around the user current position or near a specified point of interest possibly filtering them for price range, distance from the user and how the user will reach the restaurant (by car vs walking for example). The information retrieved and displayed include the distance from the user/point of interest, the phone number, address, price range, and possibly reviews.

It is possible to create lists of preferences, keep track of the favorite restaurants and so subsequently retrieve easily their information.

🤝 Contact

Paolo Pertino - @paolo-pertino - [email protected]

Project Link: https://github.com/paolopertino/TasteIt

💎 Acknowledgements

Project directed by Paolo Pertino under the supervision of Prof. Giovanni Agosta at Politecnico di Milano.