Metadata-Version: 2.4
Name: tdee-calculator
Version: 1.0.0
Summary: Lightweight Python utility for TDEE, BMR (Mifflin-St Jeor, Harris-Benedict, Katch-McArdle) and macronutrient calculations.
Author: Free TDEE Calculator
License: MIT
Project-URL: Homepage, https://freetdeecalculator.app
Project-URL: Repository, https://github.com/Free-TDEE-Calculator/tdee-calculator-js
Keywords: tdee,bmr,calorie-calculator,macros,fitness,mifflin-st-jeor
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# 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](https://freetdeecalculator.app), the free web-based toolkit for daily calorie and macro planning.

## Installation

```bash
pip install tdee-calculator
```

## Usage

```python
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

```python
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](https://freetdeecalculator.app) web app, including the detailed [macro calculator](https://freetdeecalculator.app/macro-calculator/).

## Activity levels

| Level | Multiplier | Meaning |
|---|---|---|
| sedentary | 1.2 | Little or no exercise, desk job |
| light | 1.375 | Light exercise 1-3 days/week |
| moderate | 1.55 | Moderate exercise 3-5 days/week |
| active | 1.725 | Hard exercise 6-7 days/week |
| very_active | 1.9 | Very hard daily exercise or physical job |

## License

MIT
