Repolode
karlomikus

karlomikus/bar-assistant

カクテルのレシピ、材料、在庫の管理に特化した、自宅のバー向けセルフホスト型APIサーバー。

スター
1,116
フォーク
59
未解決の Issue
15
最終コミット
昨日

これは何?

Bar Assistantは、自宅のバーを整理するためのセルフホスト型バックエンドです。汎用レシピ管理ツールとは異なり、材料の代替品、ベース材料、ABVの計算、単位変換など、カクテル特有の概念を中心に設計されています。500種類以上のカクテルレシピと、カテゴリ分けされた250種類以上のベース材料のカタログが付属します。

複数のバーを作成してメンバーやロールを設定でき、手元にある材料を記録できます。また、ABV、ベース材料、タグ、必要な材料がそろっているかどうかでレシピを絞り込めます。不足している材料から買い物リストを作成したり、材料の価格をもとにカクテルの価格を計算したりできます。レシピはURL、JSON、YAML、またはコレクションからインポートでき、公開リンクや印刷で共有できます。

このリポジトリに含まれるのはAPIサーバーのみで、Docker imageとして配布されています。キャッシュとセッションにはRedisを使用し、検索にはオプションでMeilisearchを利用できます。また、Prometheusのメトリクスエンドポイントも提供します。グラフィカルなインターフェースを使うには、別途WebクライアントのSalt Rimが必要です。

主な機能

  • 01500種類以上のカクテルレシピと250種類以上のベース材料を収録したカタログ
  • 02在庫に基づくレシピの絞り込みと買い物リストの作成
  • 03材料の代替品、バリエーション、評価、メモのカスタマイズ
  • 04複数のバー、メンバー、ユーザーロール、個人用アクセストークン
  • 05URL、JSON、YAML、またはコレクションからのレシピインポート
  • 06材料の価格に基づくカクテル価格の自動計算
  • 07オプションのシングルサインオン(SSO)とMeilisearchを利用した検索

ユースケース

  • 自宅にあるスピリッツやミキサーを記録し、作れるドリンクを探す
  • カクテルパーティーや新しいレシピに必要な買い物リストを作成する
  • 自宅のバーのメニューを運用したり、公開リンクで友人とレシピを共有したりする
  • カスタムフロントエンドや連携機能向けに、カクテルレシピAPIをセルフホストする

クイックスタート

  1. 1

    Dockerイメージを取得します(バージョンタグを指定してください。latestタグはありません)

    docker pull barassistant/server:v4
  2. 2

    Dockerイメージでサーバーを起動し、必要に応じて環境変数を設定します

使う前に知っておきたいこと

  • Redisと、必要に応じてMeilisearchが必要なため、セルフホスティングには複数のサービスが関わります。
  • これはAPIサーバーのみです。Webインターフェースを利用するには、Salt Rimなどの別のクライアントが必要です。

収録されている特集

トピック

よくある質問

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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト