Metadata-Version: 2.4
Name: ecologits
Version: 0.9.3
Summary: EcoLogits tracks and estimates the energy consumption and environmental impacts of using generative AI models through APIs.
Author: Adrien Banse
Author-email: Samuel Rincé <hello@sento.re>
License-Expression: MPL-2.0
License-File: LICENSE
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <4,>=3.10
Requires-Dist: packaging<25.0,>=24.2
Requires-Dist: pydantic<3,>=1.9.0
Requires-Dist: wrapt<2.0.0,>=1.14.1
Provides-Extra: anthropic
Requires-Dist: anthropic<0.46.0,>=0.45.2; extra == 'anthropic'
Provides-Extra: cohere
Requires-Dist: cohere<6.0.0,>=5.13.12; extra == 'cohere'
Provides-Extra: google-genai
Requires-Dist: google-genai<2.0.0,>=1.26.0; extra == 'google-genai'
Provides-Extra: huggingface-hub
Requires-Dist: aiohttp<4.0.0,>=3.11.12; extra == 'huggingface-hub'
Requires-Dist: huggingface-hub<0.29.0,>=0.28.1; extra == 'huggingface-hub'
Requires-Dist: minijinja<3.0.0,>=2.7.0; extra == 'huggingface-hub'
Requires-Dist: tiktoken<0.10.0,>=0.8.0; extra == 'huggingface-hub'
Provides-Extra: litellm
Requires-Dist: litellm<2.0.0,>=1.60.6; extra == 'litellm'
Requires-Dist: rapidfuzz<4.0.0,>=3.12.1; extra == 'litellm'
Provides-Extra: mistralai
Requires-Dist: mistralai<2.0.0,>=1.5.0; extra == 'mistralai'
Provides-Extra: openai
Requires-Dist: openai<2.0.0,>=1.61.1; extra == 'openai'
Provides-Extra: opentelemetry
Requires-Dist: opentelemetry-api<2.0.0,>=1.32.1; extra == 'opentelemetry'
Requires-Dist: opentelemetry-exporter-otlp<2.0.0,>=1.32.1; extra == 'opentelemetry'
Requires-Dist: opentelemetry-sdk<2.0.0,>=1.32.1; extra == 'opentelemetry'
Requires-Dist: tiktoken<0.10.0,>=0.8.0; extra == 'opentelemetry'
Description-Content-Type: text/markdown

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/mlco2/ecologits/main/docs/assets/logo_dark.png">
    <img alt="EcoLogits" src="https://raw.githubusercontent.com/mlco2/ecologits/main/docs/assets/logo_light.png">
  </picture>
</p>

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

[![PyPI version](https://img.shields.io/pypi/v/ecologits?color=00bf63)](https://pypi.org/project/ecologits/)
[![PyPI downloads](https://static.pepy.tech/badge/ecologits/month)](https://pepy.tech/projects/ecologits)
[![Python version](https://img.shields.io/pypi/pyversions/ecologits)](https://pypi.org/project/ecologits/)
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1VxrpJ5xuWZKQLsSN12kdqUqkppHRct3G?usp=sharing)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.15601289.svg)](https://doi.org/10.5281/zenodo.15601289)
[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?&logo=discord&logoColor=white)](https://discord.gg/CAecQ2zM4n)

Read the full **documentation on [ecologits.ai](https://ecologits.ai/)**.

EcoLogits is part of the **[CodeCarbon](https://codecarbon.io/) non-profit, chat with us on [Discord](https://discord.gg/CAecQ2zM4n)**.


## ⚙️ Installation

```shell
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](https://ecologits.ai/latest/tutorial/providers/).


## 🚀 Usage

```python
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](https://ecologits.ai/)


## 💚 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](https://ecologits.ai/latest/contributing/).


## ⚖️ License

This project is licensed under the terms of the [Mozilla Public License Version 2.0 (MPL-2.0)](https://www.mozilla.org/en-US/MPL/2.0/).
