@andi0b/pi-carbon-footprint

Show EcoLogits CO₂ and water estimates for your current Pi session.

Packages

Package details

extension

Install @andi0b/pi-carbon-footprint from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@andi0b/pi-carbon-footprint
Package
@andi0b/pi-carbon-footprint
Version
0.1.1
Published
Jun 17, 2026
Downloads
not available
Author
andi0b
License
unknown
Types
extension
Size
335 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ],
  "image": "./preview.webp"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-carbon-footprint

See the estimated environmental impact of your current Pi session directly in the UI.

The session total is shown as CO₂ equivalent and water consumption, giving you a compact view of the footprint behind your model usage.

pi-carbon-footprint screenshot

Command-line options

  • --footprint-zone <ISO3>: electricity mix zone to use for EcoLogits estimates. Defaults to WOR.
  • --no-footprint: disable footprint estimates for the session.

Example:

pi --footprint-zone USA

Commands

  • /footprint: show current-session details, including per-model output tokens and CO₂/water estimate totals.

Install/use

Install the extension package from npm:

pi install npm:@andi0b/pi-carbon-footprint

Then start Pi normally; the installed extension is discovered automatically:

pi --footprint-zone USA

You can also install it from a local checkout during development:

pi install /path/to/pi-carbon-footprint
pi

How estimates work

For each assistant response, the extension sums output tokens by provider/model, then calls the EcoLogits estimation endpoint once per (provider, model, electricity mix zone) with output_token_count: 10000. It derives midpoint-per-token values from that basis, multiplies those values by the session's accumulated assistant output tokens, and caches estimates in memory for the current Pi session.

Known issues

Supported provider mappings are intentionally conservative: openai, anthropic, mistral/mistralai, google/gemini, cohere, and huggingface variants. OpenAI-compatible providers that are not actually OpenAI are treated as unsupported by default.

Contributing

This project does not accept issues or pull requests. Create your own fork.