Public releaseYou are viewing an early public release. Original launch date: 18 May 2026. Please email hello@energymap.in for questions, issues, or feature requests.
energyatlas

Drop any package into your stack.

ies-ingest

The orchestration + contract layer for IES-shaped state-demand pipelines. Fork it into your DISCOM and own the code.

Live

Install

$ pip install ies-ingest

60-second Delhi demo

from ies_ingest.examples.one_state import run
run(state="DL", fy="FY2024-25")
# → validated StateDemandRow objects, exports artefacts
GitHub ↗PyPI ↗ies-dem-DL-FY2024-25.csv

india-energy-atlas

Consumer client over energymap.in API. Tariffs, demand, carbon intensity, DER registries, verifiable credentials — one import.

Live

Install

$ pip install india-energy-atlas

fetch live Delhi demand

from india_energy_atlas import Client
client = Client(api_key="your-key")
demand = client.grid.get_demand(state="DL", date="today")
print(demand)
GitHub ↗PyPI ↗StateDemandRow JSON

policy-as-code

Three CERC orders as machine-executable, Ed25519-signed JSON Policy Packs. Compute a retail bill offline with zero API calls.

In review

Install

$ pip install india-energy-atlas  # policy module included

verify + compute bill offline

from india_energy_atlas import policy
bill = policy.compute_bill("BRPL", kwh=350, kw=2)
# verifies signature, applies CERC order, returns itemised bill
print(f"₹{bill['total_inr']}")
GitHub ↗settlement-statement.json

energymap-mcp

MCP server for Claude Desktop, Cursor, and Antigravity. Ask questions about the Indian grid in plain English — answers backed by live IES data.

Planned

Install

$ uvx energymap-mcp

connect to Claude Desktop

// claude_desktop_config.json
{
  "mcpServers": {
    "energymap": {
      "command": "uvx",
      "args": ["energymap-mcp"],
      "env": { "ENERGYMAP_API_KEY": "<your-key>" }
    }
  }
}
GitHub ↗natural-language grid answers

Contributing

Welcome

  • → New state-name variants observed in real SLDC feeds (with source URL)
  • → Bug fixes with a regression test
  • → New Source adapters respecting the existing contract

Discuss first

  • → New runtime dependencies — each is a maintenance tax
  • → DB or message-bus coupling at the contract layer
  • → Anything that claims IES certification — we never make that claim

These packages are donations to the IES Accelerator track described in IES Architecture Document v0.4 (Ministry of Power, 27 March 2026), produced by India Energy Atlas under the Saral Systems Council, Section 8 non-profit. Not certified by IES. Code: Apache 2.0. Docs: CC-BY 4.0. Security: security@energymap.in.

/ies/conformance has the spec-citation mapping. /ies/observability has live system health.