Ecologits
🌱 EcoLogits tracks the energy consumption and environmental footprint of using generative AI models through APIs.
Install / Use
/learn @mlco2/EcologitsREADME
🌱 EcoLogits tracks the energy consumption and environmental impacts of using generative AI models through APIs.
Read the full documentation on ecologits.ai.
EcoLogits is part of the CodeCarbon non-profit, chat with us on Discord.
⚙️ 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-genai, huggingface-hub, mistralai and openai. See the full list of providers.
🚀 Usage
from ecologits import EcoLogits
from openai import OpenAI
# Initialize EcoLogits
EcoLogits.init(providers=["openai"])
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.mean} kWh")
print(f"GHG emissions: {response.impacts.gwp.value.mean} kgCO2eq")
See package documentation on EcoLogits
💚 Sponsors
<a href="https://resilio-solutions.com/" target="_blank"> <img src="https://raw.githubusercontent.com/mlco2/ecologits/main/docs/assets/sponsors/resilio.png" alt="Resilio" height="100" width="250"> </a> <a href="https://www.terra-cognita.ai/" target="_blank"> <img src="https://raw.githubusercontent.com/mlco2/ecologits/main/docs/assets/sponsors/terra_cognita.png" alt="Terra Cognita" height="100" width="250"> </a> <a href="https://sopht.com/" target="_blank"> <img src="https://raw.githubusercontent.com/mlco2/ecologits/main/docs/assets/sponsors/sopht.png" alt="Sopht" height="100" width="250"> </a> <a href="https://www.avanade.com/" target="_blank"> <img src="https://raw.githubusercontent.com/mlco2/ecologits/main/docs/assets/sponsors/avanade.png" alt="Avanade" height="100" width="250"> </a> <a href="https://www.theodo.com/" target="_blank"> <img src="https://raw.githubusercontent.com/mlco2/ecologits/main/docs/assets/sponsors/theodo.png" alt="Theodo" height="100" width="250"> </a> <a href="https://www.culture.gouv.fr/" target="_blank"> <img src="https://raw.githubusercontent.com/mlco2/ecologits/main/docs/assets/sponsors/ministere_culture.png" alt="Ministère de la Culture" height="100" width="132"> </a>💪 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).
