bar-assistant

Productivity & Wikis

An all‑in‑one API for managing home bar inventory and cocktail recipes

Track releases GitHub Website

PHP Latest v5.15.3 · 17d ago Security brief →

Features

Manage multiple bars, users, and roles with fine‑grained access control
Search and filter cocktails by ABV, ingredients, tags, and availability
Generate shopping lists, price calculations, and public bar menus
Support custom ingredient substitutes, glass types, utensils, notes, and ratings

Recent releases

View all 9 releases →

Review required

v5.15.3 Bugfix 17d

Cocktail request validation

Open

No immediate action

v5.15.2 Bugfix 1mo

Release target fix

Open

Config change

v5.15.1 Bugfix 1mo

Auth

Auth endpoint rate limiting

Open

v5.15.0 New feature 3mo

Notable features

New `/generate/cocktail-image` endpoint for AI-powered image generation
Support for OpenAI and Gemini AI providers
Added `is_ai_image_enabled` server status indicator

Full changelog

New

Added /generate/cocktail-image, used to generate cocktail images with AI

Currently only supports OpenAI and Gemini providers
Added GEN_AI_IMAGE_PROVIDER and GEN_AI_IMAGE_MODEL env variables

Examples:

# OpenAI Example
GEN_AI_IMAGE_PROVIDER=openai
GEN_AI_IMAGE_MODEL=gpt-image-1
OPENAI_API_KEY=sk-your-key

# Gemini Example
GEN_AI_IMAGE_PROVIDER=gemini
GEN_AI_IMAGE_MODEL=gemini-3.1-flash-image-preview
GEMINI_API_KEY=your-key