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 Python version Open In Colab

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-3.5-turbo",
    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

💪 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.5.2.tar.gz (29.6 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.5.2-py3-none-any.whl (36.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ecologits-0.5.2.tar.gz
  • Upload date:
  • Size: 29.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.9.20 Linux/6.5.0-1025-azure

File hashes

Hashes for ecologits-0.5.2.tar.gz
Algorithm Hash digest
SHA256 33e9ec145c733306dae86a78a875064fc040f94dcd6b3b7e5dd7de8bfe94ab65
MD5 055b7e55451b06ef4a98ccb2c611c924
BLAKE2b-256 d2f8026fcc15887ce95c8fe85ab68512aeebc364a8e3e32dad10a237ee9eb703

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ecologits-0.5.2-py3-none-any.whl
  • Upload date:
  • Size: 36.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.9.20 Linux/6.5.0-1025-azure

File hashes

Hashes for ecologits-0.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d228aba35e56ee22080ea205a0955d914384dd4be82a26ed31e9017aa503ea58
MD5 2187d2b84fabc60414e9ac4201f8af54
BLAKE2b-256 b88df4b1d346b0788d35c94d1aa83130fa44226a8814127f32ed11bde6e755cd

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