chris7neves / CocktailBerry

Easily serve Cocktails with Raspberry Pi and Python 🐍 + 🍸 = 🥳

CocktailBerry is a Python and Qt based app for a cocktail machine on the Raspberry Pi. Detailed information, installation steps and SetUp can be found at the Official Documentation.

Supercharge your next party to a whole new level! 🐍 + 🍸 = 🥳

This app is used to control a cocktail machine and easily prepare cocktails over a nice-looking user interface. It also offers the option to create and manage your recipes and ingredients over the interface and calculates the possible cocktails to prepare over given ingredients. Track and display cocktail data for different teams to even further increase the fun. Let's get started!

tl;dr

Features

CocktailBerry can do:

• Prepare cocktails of a given volume and adjusted concentration of alcoholic ingredients
• Add new ingredients and recipes with needed information over the UI
• Specify additional ingredients for later hand add within a recipe (like sticky syrup)
• Define connected ingredients to the machine and existing additional ingredients over the UI
• Auto calculates and displays possible recipes dependent on given information
• Option to serve cocktails without alcohol
• Execute a cleaning program to get rid of remaining fluids
• Export data for later data analysis, send data as mail to a receiver
• Send cocktail production data to a given endpoint, for example a webhook
• Keep track of cocktail count and volume from different teams for some fun competition

In addition, there is the possibility to use and set up a second device as a dashboard:

• Provide the teams API to post and get cocktail data
• Display different modes of data for a by team comparison
• Optional: Use the dashboard as WiFi hot-spot

Quickstart

Here are some simple steps to get CoktailBerry running. You need to have Python 3.7 or newer and git installed.

Run:

git clone https://github.com/AndreWohnsland/CocktailBerry.git
cd CocktailBerry
pip install -r requirements.txt
# you can get help with python runme.py --help
python runme.py

This will start the CocktailBerry program. You may want to run the provided installer script for the RPi instead of pip. See Installation for more information.

sh scripts/setup.sh

Now you can Set Up your CocktailBerry and tweak the settings to your liking.

Interface

The interface was programmed with PyQt5 for the users to easily interact with CocktailBerry and enter new ingredients/recipes. There are different views for the tasks.

The Maker GUI:

The Ingredient GUI:

The Recipe GUI:

The Bottle GUI:

Pull Requests and Issues

If you want to support this project, feel free to fork it and create your own pull request. If you run into any issues, feel free to open a ticket / issue. If you think there is a super important feature missing, open a feature request. It may be implemented in the future.

Contributing Possibilities

To get started, have a quick look into the Guidelines for contributing. Here is a general list of features or refacturing things, I may do in the future. With your help, these things come even faster! If your idea is not on the list, feel free to open a feature request, I may consider it!

• easy: Translate all dialogs / UI to your native language