🌱 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 Code Carbon non-profit — built by volunteers and supported by sponsors. Chat with us on Discord.
Local compute? Use CodeCarbon. Also see the other ecologits projects: Calculator, EcoLogits API, and EcoLogits.js. When to use which →
⚙️ 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
Related tools
| Tool | Link |
|---|---|
| EcoLogits API | github.com/mlco2/ecologits-api · api.ecologits.ai/docs |
| EcoLogits.js | npm — environmental impact estimates for JavaScript and TypeScript |
| Calculator | calculator.ecologits.ai |
| CodeCarbon | github.com/mlco2/codecarbon — local compute emissions |
| All mlco2 projects | github.com/mlco2 |
💚 Sponsors
Community integrations built on EcoLogits (independent projects):
- ecologits-statusline — Claude Code status line (Vincent Duarte)
- ecologits-vscode — VS Code status bar (marmelab)
💪 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
Metadata
1 maintainer
Release files for ecologits 0.11.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ecologits-0.11.3.tar.gz | 1.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ecologits-0.11.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.2 MB
Release files / ecologits-0.11.3.tar.gz
| Download URL | ecologits-0.11.3.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8887d7ac04a8368e73363f911a814f3a643e51bc0ead9da31179bd2cc03f5964
|
|
BLAKE2b-256 checksum How to use checksums |
99a289d5266c93e43f6f5267453fbabbe0554fe39145a36491a263c3994bcf41
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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}
|
Release files / ecologits-0.11.3-py3-none-any.whl
| Download URL | ecologits-0.11.3-py3-none-any.whl |
|---|---|
| Size | 57.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c477b77a95c65abbc0ed475b62708ce64ada871b675df0261f345296b0a6facd
|
|
BLAKE2b-256 checksum How to use checksums |
9e512fa567b39b22d6bda8b7ae8e8738e9aeeac53131616223c5693feea38397
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","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}
|
