EcoLogits

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

Keywords

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

Last synced: about 20 hours ago
JSON representation

Acceptance Criteria

• Revelant topics? true
• External users? true
• Open source license? true
• Active? true
• Fork? false

Repository metadata

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

• Host: GitHub
• URL: https://github.com/mlco2/ecologits
• Owner: genai-impact
• License: mpl-2.0
• Created: 2024-02-02T16:25:32.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2026-01-24T14:09:55.000Z (16 days ago)
• Last Synced: 2026-01-25T02:13:12.828Z (16 days ago)
• Topics: genai, generative-ai, green-ai, green-software, llm, llm-inference, python, sustainability, sustainable-ai
• Language: Python
• Homepage: https://ecologits.ai/
• Size: 8.74 MB
• Stars: 248
• Watchers: 12
• Forks: 23
• Open Issues: 10
• Releases: 30
• Metadata Files:
  • Readme: README.md
  • Contributing: docs/contributing.md
  • License: LICENSE
  • Citation: CITATION.cff

README.md

pip install ecologits

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")

Citation (CITATION.cff)

cff-version: "1.2.0"
authors:
- family-names: Rincé
  given-names: Samuel
  orcid: "https://orcid.org/0009-0000-0739-6114"
- family-names: Banse
  given-names: Adrien
  orcid: "https://orcid.org/0000-0002-4456-6618"
doi: 10.5281/zenodo.15601289
message: If you use this software, please cite our article in the
  Journal of Open Source Software.
preferred-citation:
  authors:
  - family-names: Rincé
    given-names: Samuel
    orcid: "https://orcid.org/0009-0000-0739-6114"
  - family-names: Banse
    given-names: Adrien
    orcid: "https://orcid.org/0000-0002-4456-6618"
  date-published: 2025-07-09
  doi: 10.21105/joss.07471
  issn: 2475-9066
  issue: 111
  journal: Journal of Open Source Software
  publisher:
    name: Open Journals
  start: 7471
  title: "EcoLogits: Evaluating the Environmental Impacts of Generative
    AI"
  type: article
  url: "https://joss.theoj.org/papers/10.21105/joss.07471"
  volume: 10
title: "EcoLogits: Evaluating the Environmental Impacts of Generative
  AI"

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

• Create event: 47
• Commit comment event: 3
• Release event: 10
• Delete event: 26
• Member event: 1
• Pull request event: 81
• Fork event: 13
• Issues event: 43
• Watch event: 127
• Issue comment event: 88
• Push event: 219
• Pull request review comment event: 52
• Pull request review event: 53

Last Year

• Create event: 37
• Commit comment event: 3
• Release event: 8
• Delete event: 20
• Pull request event: 66
• Fork event: 11
• Issues event: 28
• Watch event: 87
• Issue comment event: 70
• Push event: 161
• Pull request review comment event: 49
• Pull request review event: 43

Issue and Pull Request metadata

Last synced: 16 days ago

Dependencies

Score: -Infinity