Metadata-Version: 2.4
Name: rakam-frugal-ai
Version: 2026.6.15.1
Summary: Carbon intensity data registry for LLM and embedding models with live Electricity Maps updates
Project-URL: Homepage, https://github.com/Rakam-AI/emission-tracker
Project-URL: Repository, https://github.com/Rakam-AI/emission-tracker
Project-URL: Issues, https://github.com/Rakam-AI/emission-tracker/issues
Author-email: Samuel Gerardin <samuel@rakam.ai>
License: MIT
License-File: LICENSE
Keywords: carbon,co2,electricity-maps,emissions,llm,sustainability
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic-settings>=2.2.1
Requires-Dist: pydantic>=2.7.0
Requires-Dist: python-dotenv>=1.0.1
Provides-Extra: dev
Requires-Dist: anyio>=4.0.0; extra == 'dev'
Requires-Dist: black>=24.3.0; extra == 'dev'
Requires-Dist: build>=1.0.0; extra == 'dev'
Requires-Dist: mypy>=1.9.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.26.0; extra == 'dev'
Requires-Dist: pytest-cov>=6.2.1; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.0; extra == 'dev'
Requires-Dist: ruff>=0.4.5; extra == 'dev'
Description-Content-Type: text/markdown

# rakam-frugal-ai

Carbon intensity data registry for LLM and embedding models. Ships a precomputed, weighted-by-region probability table for popular models (GPT-4o, GPT-4o-mini, Claude, embedding models, …). Carbon intensity values are refreshed weekly from [Electricity Maps](https://www.electricitymaps.com/) — no API key required.

## Install

```bash
pip install rakam-frugal-ai
```

## Usage

```python
import rakam_frugal_ai as ci

m = ci.model("gpt-4o")
m.CI              # CarbonIntensityValue(262.010 gCO2eq/kWh)
float(m.CI)       # 262.01 — raw gCO2eq/kWh
m.size            # SizeValue(200.00B params)
float(m.size)     # 200.0 — raw billion params
m.provider        # 'openai'
m.type            # <ModelType.LLM: 'llm'>
```

## Python support

Python 3.10, 3.11, 3.12.

## License

MIT — see [LICENSE](LICENSE).
