Skip to content

feat: add EcoTrace - hardware-level carbon and energy measurement for Python - #3400

Open
Zwony wants to merge 1 commit into
vinta:masterfrom
Zwony:master
Open

Zwony wants to merge 1 commit into
vinta:masterfrom
Zwony:master

Conversation

@Zwony

@Zwony Zwony commented Nov 5, 2026

Copy link
Copy Markdown

Description

Adds EcoTrace to the Science > Sustainability subsection.

EcoTrace is a high-precision Python library for measuring exact energy consumption and CO? emissions of Python applications and AI/LLM workloads. Unlike estimation-based tools, it reads directly from hardware counters (Intel RAPL, NVML, Apple Silicon) with process-scoped isolation.

Why it belongs here:

  • Pure Python, \pip install ecotrace, zero configuration
  • MIT licensed, 100% offline and local-first
  • Hardware-level telemetry: RAPL / NVML / Apple Silicon
  • Official LangChain integration (catalogued in LangChain Integration Directory)
  • Native HuggingFace Trainer callback
  • Zenodo DOI: 10.5281/zenodo.22834060
  • OpenSSF Best Practices certified

Signed-off-by: Emre Ozkal ecotraceteam@gmail.com

Signed-off-by: Emre Ozkal <ecotraceteam@gmail.com>
Comment thread README.md

- Core
- [numpy](https://github.com/numpy/numpy) - A fundamental package for scientific computing with Python.
- [scipy](https://github.com/scipy/scipy) - Fundamental algorithms for scientific computing in Python.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [scipy](https://github.com/scipy/scipy) - Fundamental algorithms for scientific computing in Python.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💲

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [scipy](https://github.com/scipy/scipy) - Fundamental algorithms for scientific computing in Python.

Comment thread README.md
- [statsmodels](https://github.com/statsmodels/statsmodels) - Statistical modeling and econometrics in Python.
- Biology and Chemistry
- [rdkit](https://github.com/rdkit/rdkit) - Cheminformatics and machine learning software.
- [biopython](https://github.com/biopython/biopython) - Biopython is a set of freely available tools for biological computation.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [biopython](https://github.com/biopython/biopython) - Biopython is a set of freely available tools for biological computation.**
```suggestion
- [biopython](https://github.com/biopython/biopython) - Biopython is a set of freely available tools for biological computation.

**

Comment thread README.md
- [obspy](https://github.com/obspy/obspy) - A Python toolbox for seismology.
- Simulation and Modeling
- [pymc](https://github.com/pymc-devs/pymc) - Probabilistic programming and Bayesian modeling in Python.
- [simpy](https://gitlab.com/team-simpy/simpy) - A process-based discrete-event simulation framework.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [simpy](https://gitlab.com/team-simpy/simpy) - A process-based discrete-event simulation framework.

Comment thread README.md
- Simulation and Modeling
- [pymc](https://github.com/pymc-devs/pymc) - Probabilistic programming and Bayesian modeling in Python.
- [simpy](https://gitlab.com/team-simpy/simpy) - A process-based discrete-event simulation framework.
- [mesa](https://github.com/mesa/mesa) - An agent-based modeling framework for building, analyzing, and visualizing complex system simulations.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [mesa](https://github.com/mesa/mesa) - An agent-based modeling framework for building, analyzing, and visualizing complex system simulations.

Comment thread README.md
- [colour-science](https://github.com/colour-science/colour) - Implementing a comprehensive number of colour theory transformations and algorithms.
- [manim](https://github.com/ManimCommunity/manim) - An animation engine for explanatory math videos.
- Sustainability
- [EcoTrace](https://github.com/Zwony/ecotrace) - High-precision, process-scoped energy consumption and CO2 emissions measurement for Python applications and AI/LLM workloads via hardware counters (RAPL/NVML/Apple Silicon). MIT licensed, 100% offline.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [EcoTrace](https://github.com/Zwony/ecotrace) - High-precision, process-scoped energy consumption and CO2 emissions measurement for Python applications and AI/LLM workloads via hardware counters (RAPL/NVML/Apple Silicon). MIT licensed, 100% offline.
- [EcoTrace](https://github.com/Zwony/ecotrace) - High-precision, process-scoped energy consumption and CO2 emissions measurement for Python applications and AI/LLM workloads via hardware counters (RAPL/NVML/Apple Silicon). MIT licensed, 100% offline.

Comment thread README.md
- Statistics
- [statsmodels](https://github.com/statsmodels/statsmodels) - Statistical modeling and econometrics in Python.
- Biology and Chemistry
- [rdkit](https://github.com/rdkit/rdkit) - Cheminformatics and machine learning software.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [rdkit](https://github.com/rdkit/rdkit) - Cheminformatics and machine learning software.

Comment thread README.md
- [rdkit](https://github.com/rdkit/rdkit) - Cheminformatics and machine learning software.
- [biopython](https://github.com/biopython/biopython) - Biopython is a set of freely available tools for biological computation.
- Physics and Engineering
- [pint](https://github.com/hgrecco/pint) - Operate and manipulate physical quantities with units and dimensional analysis.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [pint](https://github.com/hgrecco/pint) - Operate and manipulate physical quantities with units and dimensional https://github.com/shishirroy0123-wq

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❤️❤️❤️

Comment thread README.md

- Core
- [numpy](https://github.com/numpy/numpy) - A fundamental package for scientific computing with Python.
- [scipy](https://github.com/scipy/scipy) - Fundamental algorithms for scientific computing in Python.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [scipy](https://github.com/scipy/scipy) - Fundamental algorithms for scientific computing in Python.

@JinyangWang27

Copy link
Copy Markdown
Collaborator

@Zwony Thanks for the submission. I'm considering adding a Sustainability subsection. Could you point to evidence of academic use of EcoTrace, such as papers that cite it or research groups that use it? Is there a publication about the project itself? Zenodo does not count

@Zwony

Zwony commented Nov 16, 2026

Copy link
Copy Markdown
Author

Hi @JinyangWang27,

Thank you! Having a dedicated Sustainability subsection would be a fantastic addition to awesome-python as green computing and software carbon accounting gain global traction.

To be completely transparent: Our current publication is our own Technical Whitepaper and benchmark evaluation (docs/WHITE_PAPER.md). We have recently initiated formal outreach and collaboration with university High-Performance Computing & Systems research groups to conduct physical wattmeter validation and co-author a peer-reviewed academic paper.

Because the formal peer-review and publication cycle will naturally take a few months, here is my suggestion:

  1. For now, we can list EcoTrace under "Debugging Tools -> Profiler" (alongside memray, py-spy, and scalene), where it fits naturally today as a process-level energy and hardware profiler.
  2. Once our peer-reviewed research paper is officially published with formal citations, I will open a follow-up PR with the academic DOI/paper to inaugurate the Sustainability section.

If this staged approach works for you, I'll gladly update the PR diff to place it under Debugging Tools -> Profiler!

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants