Repolode
提交项目
karlomikus

karlomikus/bar-assistant

面向家庭酒吧的自托管 API 服务，专门用于管理鸡尾酒配方、原料与库存。

在 GitHub 查看官网
Star
1,116
Fork
59
未关闭 Issue
15
最近提交
前天

这是什么？

Bar Assistant 是一个用于管理家庭酒吧的自托管后端服务。与通用菜谱管理工具不同，它围绕鸡尾酒的专属概念设计，例如原料替代品、基酒、酒精度（ABV）计算和单位换算。内置超过 500 款鸡尾酒配方和 250 多种带分类的基础原料。

用户可以创建多个酒吧并添加成员、设置角色，记录手头库存，并按酒精度、基酒、标签或是否具备所需原料筛选配方。系统可根据缺失原料生成购物清单，并依据原料价格自动计算鸡尾酒成本。配方支持通过 URL、JSON、YAML 或自定义合集导入，也可通过公开链接分享或打印。

本仓库仅包含 API 服务端，以 Docker 镜像形式提供，使用 Redis 处理缓存和会话，可选接入 Meilisearch 做搜索，并提供 Prometheus 指标接口。如需图形界面，需要搭配独立的前端项目 Salt Rim。

核心功能

  • 01内置 500 多款鸡尾酒配方和 250 多种基础原料
  • 02根据库存筛选可制作的配方，并生成购物清单
  • 03支持自定义原料替代、配方变体、评分和笔记
  • 04支持多个酒吧、成员角色与个人访问令牌
  • 05可从 URL、JSON、YAML 或合集导入配方
  • 06根据原料价格自动计算鸡尾酒成本
  • 07支持单点登录（SSO）和 Meilisearch 搜索

适用场景

  • 记录家中的烈酒和调配原料，查找可以制作的饮品
  • 为聚会或新配方生成购物清单
  • 制作家庭酒吧菜单，或通过公开链接与朋友分享配方
  • 自托管鸡尾酒配方 API，用于自定义前端或集成

快速上手

  1. 1

    拉取 Docker 镜像（需指定版本标签，没有 latest 标签）

    docker pull barassistant/server:v4
  2. 2

    使用 Docker 镜像运行服务器，并根据需要配置环境变量

使用前须知

  • 需要 Redis，并可选 Meilisearch，因此自托管涉及多个服务。
  • 这只是 API 服务器，若要网页界面需另外使用 Salt Rim 等客户端。

收录于专题

自托管应用

标签

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

常见问题

bar-assistant 是什么？
面向家庭酒吧的自托管 API 服务，专门用于管理鸡尾酒配方、原料与库存。 Bar Assistant 是一个用于管理家庭酒吧的自托管后端服务。与通用菜谱管理工具不同，它围绕鸡尾酒的专属概念设计，例如原料替代品、基酒、酒精度（ABV）计算和单位换算。内置超过 500 款鸡尾酒配方和 250 多种带分类的基础原料。
bar-assistant 可以免费使用吗？用的什么许可证？
bar-assistant 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
bar-assistant 还在维护吗？
活跃维护中。bar-assistant 最近一次提交是在 2026年11月5日。
bar-assistant 适合用来做什么？
记录家中的烈酒和调配原料，查找可以制作的饮品 为聚会或新配方生成购物清单 制作家庭酒吧菜单，或通过公开链接与朋友分享配方 自托管鸡尾酒配方 API，用于自定义前端或集成
bar-assistant 怎么安装和运行？
拉取 Docker 镜像（需指定版本标签，没有 latest 标签）: docker pull barassistant/server:v4 使用 Docker 镜像运行服务器，并根据需要配置环境变量
在哪里获取 bar-assistant？
源代码和安装说明在 GitHub 上：https://github.com/karlomikus/bar-assistant

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目