🌱 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
💪 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).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ecologits-0.11.1.tar.gz.
File metadata
- Download URL: ecologits-0.11.1.tar.gz
- Upload date:
- Size: 1.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.27 {"installer":{"name":"uv","version":"0.11.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d24df5c0202bd5925376143f5b78d7273cb015d17323e660723e07e6fad223c0
|
|
| MD5 |
309587b9bf226cadc684433a44f03260
|
|
| BLAKE2b-256 |
4b4ca7850b2dca7f148599aa4c55c049fc54244edff69b190b1d0c7a9e97ec8c
|
File details
Details for the file ecologits-0.11.1-py3-none-any.whl.
File metadata
- Download URL: ecologits-0.11.1-py3-none-any.whl
- Upload date:
- Size: 57.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.27 {"installer":{"name":"uv","version":"0.11.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a5d6b64f62a15a7c637b7cd195e1709f872e729bef020c2b64005a1a999973f2
|
|
| MD5 |
9408516c92f56ed9ba6fcfd70185919f
|
|
| BLAKE2b-256 |
c026a84f8507ece76bf8beba850b5dd634dcf8446b5a95125c83ece205c8cc01
|
