Tracarbon is a Python library that tracks your device's energy consumption and calculates your carbon emissions.
Project description
📌 Overview
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.
📦 Where to get it
# Install Tracarbon
pip install tracarbon
# Install one or more exporters from the list
pip install 'tracarbon[datadog]'
🔌 Devices: energy consumption
| Devices | Description |
|---|---|
| Mac | ✅ Global energy consumption of your Mac (must be plugged into a wall adapter). |
| Linux | ❌ Not yet implemented. See #184. |
| Windows | ❌ Not yet implemented. See #184. |
| 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. |
📡 Exporters
| Exporter | Description |
|---|---|
| Stdout | Print the metrics in Stdout. |
| Datadog | Send the metrics to Datadog. |
🗺️ Locations
| 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 |
⚙️ Configuration
| 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. |
🔎 Usage
Command Line
tracarbon run Stdout
API
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 code
💻 Development
Local: using Poetry
make init
make test-unit
🛡️ Licence
📚 Documentation
The documentation is hosted here: https://fvaleye.github.io/tracarbon/documentation
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file tracarbon-0.2.6.tar.gz.
File metadata
- Download URL: tracarbon-0.2.6.tar.gz
- Upload date:
- Size: 40.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.11 CPython/3.8.13 Linux/5.15.0-1019-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9ea433d2f8c55028211e105354441fbfac27e1ec692554447233c1ec283fd599 |
|
| MD5 | 94b66bb58aee2ec00442c7aa0b782b91 |
|
| BLAKE2b-256 | acb0f161aef9fc3db84b7d6bf4d50470e69e8c6929d0e83608cfb3e36c3d203e |
Provenance
File details
Details for the file tracarbon-0.2.6-py3-none-any.whl.
File metadata
- Download URL: tracarbon-0.2.6-py3-none-any.whl
- Upload date:
- Size: 43.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.11 CPython/3.8.13 Linux/5.15.0-1019-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1275bf914bedeba8231671cf6bafd903613cb3bc121ffd5cde57b9640b68d5b6 |
|
| MD5 | 1cacacc8aacf3ab713cedc9014f7a724 |
|
| BLAKE2b-256 | 74915fe179a5dc30d1ca51a8e1c8dcf3fca0e9d72579d72d73d44a8864c68ef5 |
