Quickstart#

Here are some simple steps to get CocktailBerry running. You need to have uv (or Python 3.13+) and git installed. If you want to use v2 in a manual installation, you also need to have Node.js and Yarn installed.

Raspberry Pi#

RPi: Try the all in one Script

If you are on your Raspberry Pi, you can just use the so-called All In One Script! This will check that git, Python and your OS are compatible for the project and install CocktailBerry including Docker and Compose on the Pi.

Just use:

wget -O - https://raw.githubusercontent.com/AndreWohnsland/CocktailBerry/master/scripts/all_in_one.sh | bash

to get the script and run it on the Pi. Too easy to be true, isn't it?

Now you can Set Up your CocktailBerry and tweak the settings to your liking. If you want to have the new v2 API and app, see web setup for how to easily switch after the setup. Or add a -s v2 at the end of the command to execute the switch directly after installing.

Other OS or Development Setup#

First clone the repository:

cd ~
git clone https://github.com/AndreWohnsland/CocktailBerry.git
cd CocktailBerry

Then choose which version you want to install.

V1 (PyQt Application)#

uv sync --extra v1 # and --extra nfc if you want NFC support
uv run runme.py

V2 (API and Web Client)#

uv sync # and --extra nfc if you want NFC support
uv run api.py

Second terminal for the web client:

cd ~/CocktailBerry/web_client
yarn install
yarn dev

This will start the CocktailBerry program. See Installation for more information.