Bar Assistant

Bar Assistant is an open-source server application designed for managing home bar inventories and cocktail recipes. It provides a specialized backend for tracking ingredients, calculating alcohol by volume (ABV), and organizing drink collections. The software focuses specifically on the requirements of mixology rather than general recipe management.

The software is deployed as a server and provides a REST API for managing cocktail data. It can be hosted using Docker images and supports integration with a separate web client or third party extensions. Users can manage multiple bars, track stock levels, and generate shopping lists based on missing ingredients. It allows for the creation of user-specific collections for easy referencing and sharing of favorite drinks.

Key features

• ABV calculations and automatic cocktail price calculation
• Inventory tracking with shopping list generation for missing items
• Recipe importing via URL, JSON, YAML, or custom collections
• Filtering of recipes by ABV, base ingredient, and available inventory
• Support for ingredient substitutes, glass types, and utensils
• User role management and personal access tokens with custom permissions
• Public bar menus and recipe sharing via public links
• Data indexing through Meilisearch integration
• Support for single sign-on (SSO) and multiple data export formats

The application is built with PHP and utilizes Redis for caching and session management. It includes a database of over 250 base ingredients and categories to streamline the setup process. For advanced search and indexing, it integrates with Meilisearch, and it offers a Prometheus metrics endpoint for monitoring server performance. The system supports the assignment of multiple images to resources and allows for detailed notes on both cocktails and ingredients. It is designed for home bartenders who require detailed tracking of their spirits and precise recipe management.

This tool serves as a dedicated API infrastructure for cocktail enthusiasts and home bar managers.