Liquor Locker

Liquor Locker is a web-based home bar management app for tracking bottles, mixers, and fresh ingredients. It combines a Go backend and React frontend to provide inventory management and AI-powered cocktail recommendations via OpenAI-compatible LLM providers.

Key Features

• Track inventory of bottles, mixers, and fresh ingredients with purchase, open, and preparation dates
• AI-powered cocktail recommendations using a user-provided OpenAI-compatible API key (supports model tool-calling and structured responses)
• Server written in Go with Swagger-documented API endpoints and a TypeScript/React frontend
• Single-binary / Docker deployments with docker-compose support and SQLite database for local storage
• Dark mode and client-side settings to configure API endpoint and model choice

Use Cases

• Manage a home bar inventory to know what cocktails are possible with on-hand ingredients
• Get recipe suggestions and variations based on available bottles and mixers
• Rapidly prototype AI-driven recipe generation or bartender-style assistants using OpenAI-compatible models

Limitations and Considerations

• AI feature requires an external OpenAI-compatible API key and may incur usage costs; model must support tool-calling for full Magic Bartender functionality
• Not all planned features are implemented (e.g., UPC scanning, saved/custom recipes, garnish tracking, multi-user or strict-mode options)
• Primary deployment targets are single-instance/local setups using SQLite; enterprise or multi-tenant deployments may require additional work

Liquor Locker is a focused personal inventory and recommendation app that pairs a lightweight Go API with a React UI to manage home bar stock and generate cocktail ideas using LLMs. It is suitable for hobbyists and developers who want a local, extendable bartender assistant.