tdee-calculator

A lightweight, dependency-free Python utility for calculating Total Daily Energy Expenditure (TDEE), Basal Metabolic Rate (BMR), calorie targets, and macronutrient splits.

Built by the team behind Free TDEE Calculator, the free web-based toolkit for daily calorie and macro planning.

Installation

pip install tdee-calculator

Usage

from tdee_calculator import calculate_tdee_profile

result = calculate_tdee_profile(
    weight_kg=75,
    height_cm=180,
    age=28,
    gender="male",
    activity_level="moderate",  # sedentary | light | moderate | active | very_active
)

print(result)
# {'bmr': 1740, 'tdee': 2697,
#  'targets': {'cut': 2158, 'maintain': 2697, 'bulk': 2967},
#  'macros': {'calories': 2697, 'protein_g': 150, 'carbs_g': 356, 'fat_g': 75}}

Individual functions

from tdee_calculator import calculate_bmr, calculate_tdee, calculate_targets, calculate_macros

# Mifflin-St Jeor (default), Harris-Benedict, Katch-McArdle
calculate_bmr(80, 182, 30, gender="male", body_fat_pct=15, formula="katch")

Formulas

• Mifflin-St Jeor (default): the most accurate widely validated BMR equation for healthy adults.
• Harris-Benedict (revised 1984 version) also supported.
• Katch-McArdle: BMR from lean body mass, ideal for lifters who know their body fat percentage.

For a fully interactive version of these formulas with visual macro breakdowns and step-by-step guidance, try the Free TDEE Calculator web app, including the detailed macro calculator.

Activity levels

License

MIT