Metadata-Version: 2.4
Name: kardashev
Version: 0.1.2
Summary: Python client for the Kardashev Labs energy data API
Project-URL: Homepage, https://kardashevlabs.org
Project-URL: API, https://data.kardashevlabs.org/docs
Project-URL: Source, https://github.com/kardashev-lab/kardashev-py
Requires-Python: >=3.9
Requires-Dist: httpx>=0.24
Provides-Extra: dev
Requires-Dist: pandas; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-httpx; extra == 'dev'
Provides-Extra: pandas
Requires-Dist: pandas>=1.5; extra == 'pandas'
Description-Content-Type: text/markdown

# kardashev

Python client for the [Kardashev Labs](https://kardashevlabs.org) energy data API - a free, open energy data platform covering LMP prices, grid load, fuel mix, carbon intensity, curtailment, interconnection queues, and more across all major US ISOs.

## Install

```bash
pip install kardashev
```

## Quick start

```python
from kardashev import Client

kl = Client()

# Live fuel mix for CAISO
fuel = kl.fuel_mix(iso="CAISO")

# Real-time LMP hub prices for MISO
prices = kl.lmp(iso="MISO", market="RT", limit=50)

# Carbon intensity (lbs CO₂/MWh) for ERCOT
carbon = kl.carbon(iso="ERCOT")

# All nodes with latest LMP for the map view
nodes = kl.lmp_map(iso="PJM", market="RT")
```

## Endpoints

| Method | Description |
|---|---|
| `fuel_mix(iso)` | Generation by fuel type |
| `carbon(iso)` | Carbon intensity (lbs CO₂/MWh) |
| `carbon_latest()` | Latest carbon intensity for all ISOs |
| `lmp(iso, market, node_id, limit)` | LMP price history |
| `lmp_map(iso, market)` | All nodes with latest price + coordinates |
| `lmp_hubs(iso)` | Hub/zone node list |
| `load(iso)` | Actual grid load |
| `load_forecast(iso)` | Load forecast |
| `generation(iso)` | Generation by unit type |
| `curtailment(iso)` | Renewable curtailment |
| `interchange(iso)` | Tie-line power flows |
| `nat_gas(hub)` | Natural gas spot prices |
| `nat_gas_storage()` | EIA weekly storage report |
| `weather(city)` | Weather observations |
| `outages(iso)` | Generator outage reports |
| `ancillary(iso, market)` | Ancillary service prices |
| `nuclear_status()` | Nuclear plant capacity factors |
| `emissions(iso)` | SO₂/NOₓ emission rates |
| `hydro(iso)` | Hydro generation |
| `solar(iso)` | Solar generation |
| `queue(iso)` | Interconnection queue |
| `commodities()` | Power/gas commodity prices |
| `carbon_markets()` | RGGI/WCI carbon market prices |

## ISOs supported

CAISO, ERCOT, ISONE, MISO, NYISO, PJM, SPP

## Custom base URL

```python
kl = Client(base_url="https://data.kardashevlabs.org")
```

## Links

- API docs: [data.kardashevlabs.org/docs](https://data.kardashevlabs.org/docs)
- Source: [github.com/kardashev-lab/kardashev-py](https://github.com/kardashev-lab/kardashev-py)
- Website: [kardashevlabs.org](https://kardashevlabs.org)
