Everything you need to install + use ebb-ai.

• get_grid_forecastread-only

  Hourly carbon-intensity forecast for a region (gCO2/kWh + band). Backs /ebb-ai:grid.

• recommend_windowread-only

  Cleanest in-deadline window + alternatives + savings vs now. Non-committal planning.

• schedule_taskwrite

  Persist a task to the SQLite queue with a deadline. Returns task_id. Backs /ebb-ai:defer.

• check_queue_statusread-only

  List all tasks or detail for one (with receipt). Backs /ebb-ai:check.

• cancel_taskwrite

  Set a task's status to cancelled. Idempotent.

• expedite_taskwrite (dispatch)

  Dispatch immediately, bypassing the scheduled window. Requires a provider API key.

• update_deadlinewrite

  Re-score a task against a new deadline. Backs /ebb-ai:reschedule.

• retry_taskwrite (dispatch)

  Re-dispatch a failed task. Requires a provider API key. Backs /ebb-ai:retry.

• cancel_allwrite

  Cancel every non-terminal task at once. Useful for clearing a corrupted queue.

* Typical = 500 input + 500 output tokens × DEFAULT_PUE = 1.15. Closed-model coefficients are inferred from public parameter-count disclosures and the Luccioni scaling curve; may be off by ±50%. Each entry in MODEL_ENERGY_COEFFICIENTS carries asource field of "measured", "estimated", or "fallback" so dashboards can render confidence alongside numbers.

import {
  estimateEnergyKwh,
  gramsForIntensity,
  lookupModelEnergy,
  MODEL_ENERGY_COEFFICIENTS,
  ENERGY_SOURCES,
  DEFAULT_PUE,
  LEGACY_KWH_PER_TASK,
} from "@ebb-ai/core";

estimateEnergyKwh({
  model: "claude-sonnet-4",
  inputTokens: 1000,
  outputTokens: 2000,
});
// => 0.01265 kWh (1.0 in + 10.0 out Wh chip × 1.15 PUE)

gramsForIntensity(400, { model: "claude-haiku-4-5" });
// => 0.41 g CO2e (haiku at 400 g/kWh grid)

estimateEnergyKwh();
// => 0.0015 kWh (v0.1-v0.9 flat fallback, bit-exact)

# Verify the receipt for a completed task in the local ledger
$ ebb verify 1c5b...e0

✓ VALID

task_id           1c5b...e0
region            US-CAL-CISO
ran_at            2026-06-01T13:00:00.000Z
actual_g_co2      2.4
estimated_g_co2   2.6
delta_pct         -7.7
model             claude-sonnet-4-5
provider          anthropic

signer_public_key OnTm5l9VbQHFv9wD...
signed_at         2026-06-01T13:00:00.184Z

Ed25519 signature verified against canonical payload (412 bytes)

# Verify a receipt JSON file (e.g. as shipped to outputPath)
$ ebb verify --file ./out/task-1c5b.json --json
{ "outcome": "valid", "signerPublicKey": "OnTm5l9VbQHFv9wD...", ... }

# Pin the expected signer for B2B/ESG pipelines
$ ebb verify --file ./inbox/receipt.json --trusted-public-key OnTm5l9V...
# exit 0 on match; exit 3 on key-mismatch

import {
  signReceipt,
  verifyReceipt,
  loadOrCreateSigningKey,
} from "@ebb-ai/core";

const keyPair = loadOrCreateSigningKey();
const signed = signReceipt(receipt, keyPair);

const result = verifyReceipt(signed);
// { outcome: "valid" | "tampered" | "legacy-unsigned" | "key-mismatch", ... }

# pip install "ebb-ai[signing]"   (pulls in the cryptography library)

from ebb_ai import (
    sign_receipt, verify_receipt,
    load_or_create_signing_key, is_signing_available,
)

key_pair = load_or_create_signing_key()
signed = sign_receipt(receipt_dict, key_pair)
result = verify_receipt(signed)
# VerifyResult(outcome='valid', signer_public_key=..., reason=...)

Verifier outcomes: valid, tampered (signed but no longer matches), legacy-unsigned (pre-v0.11 receipt — accept-or-reject is the consumer's policy), key-mismatch (signed by someone other than the trusted public key). CLI exit codes mirror these: 0 / 1 / 2 / 3.

• EBB_EIA_API_KEY

  U.S. Energy Information Administration. Unlocks live data for the six US ISOs (CISO, ERCO, ISNE, MIDA-PJM, NY-NYIS, MIDW-MISO). Free at eia.gov/opendata/register.php.

• EBB_ENTSOE_SECURITY_TOKEN

  ENTSO-E Transparency Platform. Unlocks live data for European zones (FR, DE, ES, IT, NL). Free at transparency.entsoe.eu.

• EBB_ELECTRICITY_MAPS_API_KEY

  Electricity Maps free tier (100 req/day). Universal fallback for any other zone. Free at electricitymaps.com/free-tier-api.

• ANTHROPIC_API_KEY · OPENAI_API_KEY

  Required only if you want ebb-ai to actually dispatch provider calls (vs. just queueing them). Either is enough.