randominterests / bar-assistant

Bar assistant is a self hosted application for managing your home bar.

🍸 Bar Assistant

Bar Assistant is a self hosted application for managing your home bar. It allows you to search and filter cocktails, add ingredients and create custom cocktail recipes.

This repository only contains the API server, if you are looking for easy to use web client, take a look at Salt Rim.

Click here to view API demo.
Click here to view frontend demo.
Email: [email protected] · Password: password

Features

• Includes all current IBA cocktails
• Over 100 ingredients
• Endpoints for managing of ingredients and cocktails
• Mark ingredients you have and get all cocktails that you can make
• Detailed cocktail and ingredient information
• Ability to upload and assign images
• Shopping list for missing ingredients
• Automatic indexing of data in Meilisearch
• Cocktail ingredient substitutes
• Assign glass types to cocktails
• Cocktail recipe scraping
• Cocktail ratings

Documentation

Documentation is available here.

Contributing

Feel free to create a pull request or open a issue with bugs/feature ideas.

Development environment

You can use docker to quick start with the development.

1. Clone the repository
2. Copy .env.dev as .env, or setup your own env file
3. Run docker compose up -d
4. Then run the following commands:

$ docker compose exec app composer install
$ docker compose exec app php artisan key:generate
$ docker compose exec app php artisan storage:link
$ docker compose exec app php artisan migrate
$ docker compose exec app php artisan bar:open

License

The Bar Assistant API is open-sourced software licensed under the MIT license.