Tracarbon is a Python library that tracks your device's energy consumption and calculates your carbon emissions.
It detects your location and your device automatically before starting to export measurements to an exporter. It could be used as a CLI with already defined metrics or programmatically with the API by defining the metrics that you want to have.
Read more in this article.
# Install Tracarbon
pip install tracarbon# Install one or more exporters from the list
pip install 'tracarbon[datadog]'| Devices | Description |
|---|---|
| Mac | ✅ Global energy consumption of your Mac (must be plugged into a wall adapter). |
| Linux | ❌ Not yet implemented. |
| Windows | ❌ Not yet implemented. |
| Cloud Provider | Description |
|---|---|
| AWS | ✅ Used the CPU usage with the EC2 instances carbon emissions datasets of cloud-carbon-coefficients. |
| GCP | ❌ Not yet implemented. |
| Azure | ❌ Not yet implemented. |
| Exporter | Description |
|---|---|
| Stdout | Print the metrics in Stdout. |
| Datadog | Send the metrics to Datadog. |
| Location | Description | Source |
|---|---|---|
| Europe | Static file of the European Environment Agency Emission for the co2g/kwh for European countries. | EEA website |
| France | Get the co2g/kwh in near real-time using the RTE energy consumption. | RTE API |
| AWS | Static file of the AWS Grid emissions factors. | cloud-carbon-coefficients |
| Parameter | Description |
|---|---|
| TRACARBON_API_ACTIVATED | The activation of the real-time data collection of the carbon emission factor. |
| TRACARBON_METRIC_PREFIX_NAME | The prefix to use in all the metrics name. |
| TRACARBON_INTERVAL_IN_SECONDS | The interval in seconds to wait between the metrics evaluation. |
| TRACARBON_LOG_LEVEL | The level to use for displaying the logs. |
Command Line
tracarbon run StdoutAPI
from tracarbon import CarbonEmission
from tracarbon.exporters import Metric, StdoutExporter
metric = Metric(
name="co2_emission",
value=CarbonEmission().run,
tags=[],
)
exporter = StdoutExporter(metrics=[metric])
exporter.start()
# Your code
exporter.stop()
with exporter:
# Your codeLocal: using Poetry
make setup
make unit-testThe documentation is hosted here: https://fvaleye.github.io/tracarbon/documentation
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent