EcoLogits

Tracks the energy consumption and environmental impacts of using generative AI models through APIs.
https://github.com/genai-impact/ecologits

Category: Consumption
Sub Category: Computation and Communication

Keywords

genai generative-ai green-ai green-software llm llm-inference python sustainability sustainable-ai

Last synced: about 12 hours ago
JSON representation

Repository metadata

🌱 EcoLogits tracks the energy consumption and environmental footprint of using generative AI models through APIs.

Host: GitHub
URL: https://github.com/genai-impact/ecologits
Owner: genai-impact
License: mpl-2.0
Created: 2024-02-02T16:25:32.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2025-04-04T16:02:12.000Z (23 days ago)
Last Synced: 2025-04-19T16:36:46.799Z (8 days ago)
Topics: genai, generative-ai, green-ai, green-software, llm, llm-inference, python, sustainability, sustainable-ai
Language: Python
Homepage: https://ecologits.ai/
Size: 4.84 MB
Stars: 156
Watchers: 12
Forks: 16
Open Issues: 14
Releases: 20
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE

README.md

🌱 EcoLogits tracks the energy consumption and environmental impacts of using generative AI models through APIs.

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-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} kWh")
print(f"GHG emissions: {response.impacts.gwp.value} 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).

Owner metadata

Name: GenAI Impact
Login: genai-impact
Email:
Kind: organization
Description:
Website:
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/166227099?v=4
Repositories: 1
Last ynced at: 2024-04-17T18:43:17.216Z
Profile URL: https://github.com/genai-impact

GitHub Events

Total

Fork event: 7
Create event: 19
Commit comment event: 3
Release event: 6
Issues event: 32
Watch event: 81
Delete event: 9
Member event: 1
Issue comment event: 45
Push event: 140
Pull request review comment event: 16
Pull request review event: 32
Pull request event: 39

Last Year

Fork event: 7
Create event: 19
Commit comment event: 3
Release event: 6
Issues event: 32
Watch event: 81
Delete event: 9
Member event: 1
Issue comment event: 45
Push event: 140
Pull request review comment event: 16
Pull request review event: 32
Pull request event: 39

Committers metadata

Last synced: 6 days ago

Total Commits: 535
Total Committers: 10
Avg Commits per committer: 53.5
Development Distribution Score (DDS): 0.355

Commits in past year: 332
Committers in past year: 6
Avg Commits per committer in past year: 55.333
Development Distribution Score (DDS) in past year: 0.34

Name	Email	Commits
Samuel Rince	s@r****e	345
Adrien Banse	a**e@u**e	135
luc	l**n@t**m	32
Nina P	2****v	7
vinh	v**4@h**r	5
Luc BERTON	l**n@g**m	4
Clovis Varangot-Reille	1****i	2
yco	y**n@c**u	2
Luc	l**c@t**r	2
DataForGood (Tech)	1****h	1

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 56
Total pull requests: 74
Average time to close issues: 29 days
Average time to close pull requests: 3 days
Total issue authors: 18
Total pull request authors: 9
Average comments per issue: 2.38
Average comments per pull request: 0.64
Merged pull request: 68
Bot issues: 0
Bot pull requests: 0

Past year issues: 37
Past year pull requests: 52
Past year average time to close issues: 26 days
Past year average time to close pull requests: 4 days
Past year issue authors: 17
Past year pull request authors: 8
Past year average comments per issue: 1.89
Past year average comments per pull request: 0.58
Past year merged pull request: 47
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/genai-impact/ecologits

Top Issue Authors

samuelrince (17)
adrienbanse (9)
NP4567-dev (6)
LucBERTON (6)
ExploratoriumGPT (2)
gecBurton (2)
Neyri (2)
cvarrei (2)
benoit-cty (1)
cleophas-dlg (1)
TLSDC (1)
thilomichael (1)
ketsapiwiq (1)
thomasGuerin3 (1)
vdwow (1)

Top Pull Request Authors

samuelrince (38)
adrienbanse (23)
LucBERTON (4)
NP4567-dev (3)
ycouble (2)
aqwvinh (1)
C-BdB (1)
cvarrei (1)
thilomichael (1)

Top Issue Labels

feature request (13)
bug (11)
documentation (2)
enhancement (1)
good first issue (1)
question (1)

Top Pull Request Labels

documentation (1)

Dependencies

.github/workflows/pre-commit.yaml actions

actions/cache v1 composite
actions/checkout v2 composite
actions/setup-python v2 composite
pre-commit/action v3.0.0 composite

poetry.lock pypi

cachetools 5.3.2
cfgv 3.4.0
chardet 5.2.0
colorama 0.4.6
distlib 0.3.8
exceptiongroup 1.2.0
filelock 3.13.1
identify 2.5.35
iniconfig 2.0.0
nodeenv 1.8.0
packaging 23.2
platformdirs 4.2.0
pluggy 1.4.0
pre-commit 2.21.0
pyproject-api 1.6.1
pytest 7.4.4
pyyaml 6.0.1
setuptools 69.1.0
tomli 2.0.1
tox 4.13.0
virtualenv 20.25.0

pyproject.toml pypi

pre-commit ^2.20.0 develop
pytest ^7.2.0 develop
tox ^4.4.8 develop
python >=3.8,<4

Score: 7.438383530044308

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology