Skip to main content

EcoLogits tracks and estimates the energy consumption and environmental impacts of using generative AI models through APIs.

Project description

EcoLogits

🌱 EcoLogits tracks the energy consumption and environmental impacts of using generative AI models through APIs.

PyPI version PyPI downloads Python version Open In Colab DOI

EcoLogits was created and is actively maintained by the GenAI Impact non-profit.

Read the full documentation on ecologits.ai.

⚙️ Installation

pip install ecologits

For integration with a specific provider, use pip install ecologits[openai]. We are currently supporting the following providers: anthropic, cohere, google-generativeai, huggingface-hub, mistralai and openai. See the full list of providers.

🚀 Usage

from ecologits import EcoLogits
from openai import OpenAI

# Initialize EcoLogits
EcoLogits.init()

client = OpenAI(api_key="<OPENAI_API_KEY>")

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "user", "content": "Tell me a funny joke!"}
    ]
)

# Get estimated environmental impacts of the inference
print(f"Energy consumption: {response.impacts.energy.value} kWh")
print(f"GHG emissions: {response.impacts.gwp.value} kgCO2eq")

See package documentation on EcoLogits

💚 Sponsors

Resilio

💪 Contributing

To get started with setting up a development environment and making a contribution to EcoLogits, see Contributing to EcoLogits.

⚖️ License

This project is licensed under the terms of the Mozilla Public License Version 2.0 (MPL-2.0).

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

ecologits-0.6.3.tar.gz (31.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ecologits-0.6.3-py3-none-any.whl (39.7 kB view details)

Uploaded Python 3

File details

Details for the file ecologits-0.6.3.tar.gz.

File metadata

  • Download URL: ecologits-0.6.3.tar.gz
  • Upload date:
  • Size: 31.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.9.21 Linux/6.8.0-1021-azure

File hashes

Hashes for ecologits-0.6.3.tar.gz
Algorithm Hash digest
SHA256 6ecee491175212d9b933e79d8d65c8f8ce6c812a160fe3941a2ededa1f97eade
MD5 9228235062d2282a2666171359fbe922
BLAKE2b-256 f7c82cc3b6600ac25366f317da4d0ba6e682e41aa6d1732e7317c3d6ada5ba02

See more details on using hashes here.

File details

Details for the file ecologits-0.6.3-py3-none-any.whl.

File metadata

  • Download URL: ecologits-0.6.3-py3-none-any.whl
  • Upload date:
  • Size: 39.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.9.21 Linux/6.8.0-1021-azure

File hashes

Hashes for ecologits-0.6.3-py3-none-any.whl
Algorithm Hash digest
SHA256 6e269b369b2f6f3980ab20c0ae50c2135171f0e05095ac7c5bfc56641d3ae056
MD5 5a338c209c7f058f7f7018de4edc1885
BLAKE2b-256 59cd5a56c0c9b30855bb2231b82e4521706d7de19aef0284012bbdbe4f4ded92

See more details on using hashes here.

Supported by

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