Repolode
Submit
karlomikus

karlomikus/bar-assistant

Self-hosted API server for managing a home bar, built specifically around cocktail recipes, ingredients and inventory.

View on GitHubWebsite
Stars
1,116
Forks
59
Open issues
15
Last commit
yesterday

What is it?

Bar Assistant is a self-hosted backend for organizing a home bar. Unlike general-purpose recipe managers, it is built around cocktail-specific concepts such as ingredient substitutes, base ingredients, ABV calculations and unit conversion. It ships with a catalog of over 500 cocktail recipes and more than 250 base ingredients with categories.

Users can create multiple bars with members and roles, track what is on hand, and filter recipes by ABV, base ingredient, tags, or whether they have the required ingredients. It can generate shopping lists from missing items and calculate cocktail prices from ingredient prices. Recipes can be imported from URLs, JSON, YAML or collections, and shared through public links or printing.

This repository contains only the API server, distributed as a Docker image. It uses Redis for caching and sessions and optionally Meilisearch for search, and offers a Prometheus metrics endpoint. A separate web client, Salt Rim, is needed for a graphical interface.

Key features

  • 01Catalog of over 500 cocktail recipes and 250+ base ingredients
  • 02Inventory-based recipe filtering and shopping list generation
  • 03Custom ingredient substitutes, variations, ratings and notes
  • 04Multiple bars with members, user roles and personal access tokens
  • 05Recipe import from URLs, JSON, YAML or collections
  • 06Automatic cocktail price calculation from ingredient prices
  • 07Optional single sign-on (SSO) and Meilisearch-powered search

Use cases

  • Tracking what spirits and mixers you have at home and finding drinks you can make
  • Generating a shopping list for a cocktail party or a new recipe
  • Running a home bar menu or sharing recipes with friends via public links
  • Self-hosting a cocktail recipe API for a custom frontend or integration

Quick start

  1. 1

    Pull the Docker image (specify a version tag, there is no latest tag)

    docker pull barassistant/server:v4
  2. 2

    Run the server with the Docker image and configure environment variables as needed

Things to know

  • Requires Redis and optionally Meilisearch, so self-hosting involves several services.
  • It is only the API server; a separate client such as Salt Rim is needed for a web interface.

In collections

Self-hosted apps

Topics

#cocktails#recipes#home-bar#php#rest-api#self-hosted#docker#inventory#api#bar

FAQ

What is bar-assistant?
Self-hosted API server for managing a home bar, built specifically around cocktail recipes, ingredients and inventory. Bar Assistant is a self-hosted backend for organizing a home bar. Unlike general-purpose recipe managers, it is built around cocktail-specific concepts such as ingredient substitutes, base ingredients, ABV calculations and unit conversion. It ships with a catalog of over 500 cocktail recipes and more than 250 base ingredients with categories.
Is bar-assistant free to use? What license does it have?
bar-assistant is open source under the MIT license. Check the license terms before using it in commercial products.
Is bar-assistant still maintained?
Actively maintained. The last commit to bar-assistant was on Nov 5, 2026.
What can I use bar-assistant for?
Tracking what spirits and mixers you have at home and finding drinks you can make Generating a shopping list for a cocktail party or a new recipe Running a home bar menu or sharing recipes with friends via public links Self-hosting a cocktail recipe API for a custom frontend or integration
How do I install bar-assistant?
Pull the Docker image (specify a version tag, there is no latest tag): docker pull barassistant/server:v4 Run the server with the Docker image and configure environment variables as needed
Where can I get bar-assistant?
The source code and installation instructions are on GitHub: https://github.com/karlomikus/bar-assistant

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects