/DrinkGenius-Bot

Your personal assistant in the world of cocktails - recipes, recommendations and tips on your screen.

Primary LanguagePython

DrinkGenius Bot

Welcome to DrinkGenius Bot, your personal cocktail expert on Telegram! This bot is designed to provide you with a wide range of cocktail recommendations, recipes, and ingredients right at your fingertips. Whether you're a seasoned mixologist or a beginner looking to impress your friends, DrinkGenius Bot has got you covered.

How It Works

DrinkGenius Bot utilizes the pyTelegramBotAPI to interact with users on Telegram. Before starting the bot you must run script called website_scraper.py to scrape data from the popular website inshaker.com. This data includes essential attributes such as images, names, ingredients, recipes, and various categories like degree, taste, base, and category.

The main functionality is handled by the cocktail_bot.py file, which acts as the brain of the bot. Here's a breakdown of its key features (still in progress):

  1. Cocktail Recommendations: Get personalized cocktail recommendations based on your preferences.
  2. Recipe and Ingredients: Access detailed recipes and ingredient lists for each cocktail.
  3. Search Functionality: Search for cocktails by categories, such as degree, taste, base, and category.
  4. Similar Cocktails: Get similar cocktails list based on their ingredients.

To-Do List:

  • Improve Readability: Enhance the codebase to make it more readable and maintainable.
  • Recommendation System: Implement a simple recommendation system based on preferred ingredients.
  • Additional Functionality: Expand features like advanced search options and cocktail history.

Getting Started

To start using DrinkGenius Bot, simply search for @cocktail_recommendation_bot on Telegram and start a conversation. Follow the prompts to explore cocktails, find recipes, and discover new favorites.

Command Example

/recipe

recipe_example

The Levenshtein algorithm allows us to find the desired output even if there are minor mistakes that we can ignore.

/similar

similar_example

You get 3 similar cocktails to the one you provide. All of them are clickable.

Contributing

If you're passionate about mixology and Python development, we welcome contributions to improve DrinkGenius Bot. Whether it's enhancing existing features, adding new functionality, or fixing bugs, your contributions are valuable.

Feedback and Support

We're committed to continuously improving DrinkGenius Bot to enhance your cocktail experience. If you have any feedback, suggestions, or encounter any issues while using the bot, please don't hesitate to reach out.

Enjoy exploring the world of cocktails with DrinkGenius Bot! Cheers! 🍹🤖