BulkCut Coach - Fitness & Diet Tracker

Uses Gemini 3 Flash (via OpenRouter) for food photo analysis and personalized planning.

How to Use

All commands run from the project root. Parse the user's natural language and call the appropriate command via Bash.

Food Photo Analysis

When user shares a food image path:

python scripts/app.py photo <image_path>

Text Meal Logging

When user describes what they ate:

python scripts/app.py meal "<description>"

Workout Logging

When user describes their training (exercises, sets, reps, weight), do NOT use the interactive

train

command. Instead call Python directly:

python -c "
import sys; sys.path.insert(0, 'scripts')
from training import log_training
r = log_training([
    {'name': '<exercise>', 'sets': <n>, 'reps': <n>, 'weight_kg': <n>},
])
print(f'Calories burned: {r[\"calories_burned\"]} kcal')
"

Parse the user's natural language into the exercise list. Examples:

• "4x4 squat at 112.5kg" →

  {'name': 'Back Squat', 'sets': 4, 'reps': 4, 'weight_kg': 112.5}

• "3x2 power clean 67.5kg" →

  {'name': 'Power Clean', 'sets': 3, 'reps': 2, 'weight_kg': 67.5}

Body Metrics

When user provides height/weight/age/gender/body fat:

python -c "
import sys; sys.path.insert(0, 'scripts')
from metabolism import set_metrics
p = set_metrics(<height_cm>, <weight_kg>, <age>, '<gender>', <body_fat_pct_or_None>)
print(f'BMR: {p[\"bmr\"]} kcal/day\nTDEE: {p[\"tdee\"]} kcal/day')
"

Goal Setting

python scripts/app.py goal <cut|bulk|maintain>

Daily Summary

python scripts/app.py summary

Generate Plan

python scripts/app.py plan

History

python scripts/app.py history