Bar Assistant

Bar Assistant is a cocktail-focused platform for managing home (or small venue) bar recipes and ingredient inventory. It combines recipe management, bar organization, and pricing tools, and exposes an API for integrations.

Key Features

• Manage cocktail recipes with notes, ratings, favorites, images, and variations
• Ingredient inventory with categories, units, pricing, and ingredient substitutes
• ABV calculations, unit switching, and recipe scaling by volume or servings
• Powerful search and filtering by tags, base ingredients, available inventory, and more
• Shopping list generation based on missing ingredients
• Create and publish bar menus with pricing, pour cost calculations, and exports
• Import and export recipes and ingredients in multiple formats (including JSON, YAML, CSV, and Markdown)
• Multi-bar and multi-user support with roles and fine-grained access control
• Personal access tokens with custom permissions and single sign-on (SSO) support
• Optional search indexing and metrics support for improved discovery and monitoring

Use Cases

• Track a personal home bar inventory and quickly find cocktails you can make
• Plan an event by calculating quantities and generating shopping lists
• Maintain and publish a cocktail menu with cost-based pricing

Limitations and Considerations

• This repository contains the API server; the main web UI is provided by a separate client application
• Some search features depend on an external search service being configured

Bar Assistant is a strong fit for cocktail enthusiasts who want structure around ingredients and inventory, as well as for groups sharing a bar with role-based access. Its data portability, menu tools, and API make it practical to extend and integrate into a broader homelab setup.