BeanRatio

コーヒー豆の最適なレシオを記録・算出するCLIアプリ

概要

豆ごとに抽出の濃さが異なるため、毎日のログを記録して最適な豆と水の比率を学習していくツールです。

• 基本レシオ: 250ml抽出で14g（約1:17.9）
• 1日1回の試行記録
• 豆ごとに最適なレシオを算出

セットアップ

前提条件

• Python 3.10以上
• uv
• Task

インストール

# 依存関係をインストール
task install

使い方

豆を登録

task add-bean -- "エチオピア イルガチェフェ"
task add-bean -- "コロンビア" --notes "フルーティーな香り"

今日の抽出を記録

# 豆量と水量を指定
task log -- "エチオピア" --beans 14 --water 250 --strength 0
task log -- "エチオピア" -b 15 -w 250 -s +1 --notes "少し濃かった"

# お気に入りが設定されている場合は省略可能（strengthのみ必須）
task log -- "エチオピア" -s 0
task log -- "エチオピア" -s -1 --notes "今日は少し薄かった"

# 豆量のみ変更（水量はお気に入りを使用）
task log -- "エチオピア" -b 15 -s +1

濃さの評価（必須）:

• -2: Too Weak（薄すぎる）
• -1: Weak（やや薄い）
• 0: Perfect（最適）← これが目標
• +1: Strong（やや濃い）
• +2: Too Strong（濃すぎる）

推奨レシオと豆量を確認

task recommend -- "エチオピア"
task recommend -- "エチオピア" --water 300

豆の一覧を表示

task list

豆の詳細情報を表示

task show -- "エチオピア"

履歴を表示

task history -- "エチオピア"
task history -- "エチオピア" --limit 20

お気に入りを設定

最適な組み合わせをお気に入りとして保存できます。お気に入りを設定すると、logコマンドで豆量・水量を省略できます。

task set-favorite -- "エチオピア" -b 14 -w 250 --notes "完璧な濃さ"

# お気に入り設定後は簡単にログを記録できる
task log -- "エチオピア" -s 0

ログを削除

# 特定のログを削除（インデックスは history コマンドで確認）
task delete-logs -- "エチオピア" --index 0

# 特定の豆のログをすべて削除
task delete-logs -- "エチオピア" --all

# すべてのログをクリア（豆情報は残る）
task clear-logs

レシオ最適化アルゴリズム

• 評価0（Perfect）の記録を重視
• 最近の記録ほど重みを高く設定
• 最低3回の記録で推奨レシオを算出
• 評価0からの距離に応じて重みを調整

データ保存

• data/beans.json: 豆の情報
• data/logs.json: 抽出ログ

JSONファイルで保存されるため、バックアップや編集が容易です。

コマンド一覧

task install       # 依存関係インストール
task add-bean      # 豆を追加
task log           # 今日の記録
task recommend     # 推奨レシオ表示
task list          # 豆一覧（お気に入りも表示）
task show          # 豆の詳細情報を表示
task history       # 履歴表示
task set-favorite  # お気に入りを設定
task delete-logs   # ログを削除
task clear-logs    # すべてのログをクリア
task help          # ヘルプ表示

直接実行

Taskを使わず直接実行する場合:

uv run beanratio --help
uv run beanratio add-bean "豆の名前"
uv run beanratio log "豆の名前" -b 14 -w 250 -s 0
uv run beanratio recommend "豆の名前"
uv run beanratio list
uv run beanratio history "豆の名前"