wattindex

wattindex

100 万出力トークンを提供するには、どれだけの GPU エネルギーが必要でしょうか。wattindex は、測定済み構成の公開インデックスから、モデル、GPU、実行バッチごとの 100 万出力トークンあたりのワット時を回答し、グリッドの炭素強度を使って、どこでもエネルギーのコストを算出します。

• 最適な行の選択では、トークン間レイテンシの中央値が指定した期限（itl_deadline_ms、デフォルトは 500 ms）以下の行だけを対象とし、その中でエネルギー消費が最も少ない行を選びます。
• estimate は、任意のトークン数に合わせて行の値を換算し、国の電力網に基づく kg CO2e を加算します。また、pue や system_power_ratio（いずれも 1.0 以上）を指定すると、メーターでのエネルギーも算出し、指定した前提に基づく値として表示します。
• すべての応答に、測定境界（gpu_only）、インデックスに記載された注意事項、データの取得元（ライブ API、同梱スナップショット、ローカルフォルダーのいずれか）、更新日、データバージョンが含まれます。

データは LEADGREEN_API_BASE の JSON API ベース（デフォルトは https://leadgreen.ai/api/v1）から読み込みます。URL 以外の値を指定すると、API ファイルを格納したローカルフォルダーとして扱われ、完全なオフライン利用が可能です。すべての検索と計算はローカルで行われます。

CLI

npx @reneturcios/wattindex list-models
npx @reneturcios/wattindex energy --model llama-3.1-70b --gpu H100
npx @reneturcios/wattindex estimate --model llama-3.1-70b --output-tokens 5000000 --country DE --pue 1.2
npx @reneturcios/wattindex compare-gpus --model llama-3.1-70b
npx @reneturcios/wattindex concurrency-curve --model llama-3.1-70b --gpu H100
npx @reneturcios/wattindex grid-intensity --country World
npx @reneturcios/wattindex gpu-hardware --gpu B200
npx @reneturcios/wattindex sources
npx @reneturcios/wattindex --version

出力は JSON です。終了コード：成功時は 0、実行時エラー（不明なモデル／GPU／国、読み取り不能または到達不能なデータセット）の場合は 1、使用方法のエラーの場合は 2 です。

MCP サーバー

npx -y @reneturcios/wattindex mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "wattindex": {
      "command": "npx",
      "args": ["-y", "@reneturcios/wattindex", "mcp"]
    }
  }
}

ツール

• list_models — インデックス内のモデルと、各モデルの測定値がある GPU
• energy_per_million_tokens — モデルごとの GPU 別最適行
  • model（文字列、必須）、gpu（文字列、省略可）、itl_deadline_ms（数値、省略可、デフォルトは 500）
• estimate — 指定したトークン数に対する GPU エネルギー、kg CO2e、オプションでメーターでのエネルギー
  • model（文字列、必須）、output_tokens（数値、必須）、gpu、country、running_batch、num_gpus、itl_deadline_ms、pue、system_power_ratio（省略可）
• compare_gpus — モデルごとの H100 と B200 の最適行
  • model（文字列、必須）、itl_deadline_ms（省略可）
• concurrency_curve — 測定済みの各実行バッチにおけるエネルギー
  • model、gpu（文字列、必須）
• grid_intensity — 国の年間平均 gCO2e/kWh （国名、略称、ISO alpha-2／alpha-3、または World）
  • country（文字列、必須）
• gpu_hardware — 最大 TDP、メモリ、MIG プロファイル、システム全体の上限
  • gpu（文字列、省略可。省略するとすべての GPU を一覧表示）
• sources — すべてのソース、バージョン、取得日、ライセンス

Docker

docker run -i ghcr.io/cloudcorprecords/wattindex
docker run --rm ghcr.io/cloudcorprecords/wattindex grid-intensity --country DE

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake loader, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios