Skip to main content

Tracarbon is a Python library that tracks your device's energy consumption and calculates your carbon emissions.

Project description

Alt text

doc pypi example workflow

📌 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.
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.

📡 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 setup
make unit-test

🛡️ Licence

Apache License 2.0

📚 Documentation

The documentation is hosted here: https://fvaleye.github.io/tracarbon/documentation

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tracarbon-0.2.5.tar.gz (40.1 kB view details)

Uploaded Source

Built Distribution

tracarbon-0.2.5-py3-none-any.whl (43.6 kB view details)

Uploaded Python 3

File details

Details for the file tracarbon-0.2.5.tar.gz.

File metadata

  • Download URL: tracarbon-0.2.5.tar.gz
  • Upload date:
  • Size: 40.1 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

Hashes for tracarbon-0.2.5.tar.gz
Algorithm Hash digest
SHA256 30e94dd4e72cbbf8a6390fd33f451862e9ef2cd3306424c4e639a9fd536f32c5
MD5 7e7c576b1ba419a48fa7f4d08df01e9e
BLAKE2b-256 c8bff70c10a2e2997a8f9eb930d5994aea919b615815a861b6848138ea664dd1

See more details on using hashes here.

Provenance

File details

Details for the file tracarbon-0.2.5-py3-none-any.whl.

File metadata

  • Download URL: tracarbon-0.2.5-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

Hashes for tracarbon-0.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 ff3c0b04ab0cada5bdb603a7df48a4adf41a513c1a351df335226aa831436b70
MD5 f0c47c3052563a32fbe7ac3fc4ab0edc
BLAKE2b-256 e845532760cb21e48c84c0448caf4ec4e3cfbaeec30a054b51822ece4e8a4764

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page