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

Documentation: 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.1.tar.gz (29.3 kB view details)

Uploaded Source

Built Distribution

ecologits-0.5.1-py3-none-any.whl (36.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ecologits-0.5.1.tar.gz
  • Upload date:
  • Size: 29.3 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.1.tar.gz
Algorithm Hash digest
SHA256 2ddf45169f13f6add6a3008cc9b9ed763413925ebf9a3c90bcf4661202e5878b
MD5 b220e17aa271353664d7bbf9594513c2
BLAKE2b-256 595ae8fbd1f412b89770814a77c2a360f9f2ed9152f2f0539d600165ae855c2c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ecologits-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 36.1 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e1bd4fc9dbe6ba01b32a359ec62f0967e9cc4ca334f179c96603a228858dc1a0
MD5 9bbc83a1eb8e67730f2291d804d09dee
BLAKE2b-256 16cad7e7e0719b5de8e2c721dcd04488455677f21cb15d13034a8563ad83795a

See more details on using hashes here.

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