I Built a Python Library That Measures Your Code's Carbon Footprint

The Problem My machine learning scripts run for hours. One day I got curious — how much CO₂ am I actually emitting while training models? I searched for a simple Python library to measure this. Nothing fit. So I built one. Introducing EcoTrace EcoTrace is a lightweight Python library that measures the carbon footprint of your functions using real-time CPU and GPU utilization sampling. pip install ecotrace How It Works from ecotrace import EcoTrace eco = EcoTrace ( region_code = " US " ) @eco.track def train_model (): return sum ( i * i for i in range ( 10 ** 6 )) train_model () # [EcoTrace] Function : train_model # [EcoTrace] Duration : 0.0452 sec # [EcoTrace] CO2 : 0.00001823 gCO2 The carbon formula is simple: energy (Wh) = TDP × cpu_usage% × duration / 3600 CO2 (gCO2) = (energy / 1000) × carbon_intensity What Makes It Different Most tools assume 100% CPU/GPU utilization (full TDP) for the entire duration. EcoTrace uses continuous sampling every 50ms to measure actual utilization — gi