epwforge 0.0.1

Python client for EPWForge — generate climate-stressed EPW weather files for any global location. Custom TMYx / AMY from ERA5, CMIP6 future-climate morphing across SSP scenarios, urban heat island, extreme-event injection (heat waves, cold snaps, compound humidity/wind), and wildfire smoke overlays. For EnergyPlus, OpenStudio, IES VE, eQUEST.

epwforge

Python client for EPWForge — generate climate-stressed EPW weather files for any global location. Custom TMYx / AMY from ERA5, CMIP6 future-climate morphing, urban heat island, extreme-event injection, and wildfire smoke overlays. For EnergyPlus, OpenStudio, IES VE, eQUEST.

Status: name reserved at 0.0.1. The functional client ships in 0.1.0 — for now use:

• The REST API directly: epwforge.com/docs
• The MCP server for AI agents: pip install epwforge-mcp

What this will be

A thin, well-typed Python wrapper around the EPWForge REST API. Targets the same surface as the MCP server:

from epwforge import Client

client = Client(api_key="sk_live_...")

# Custom TMYx for anywhere on Earth
client.weather_file(lat=40.71, lon=-74.01, save_to="nyc.epw")

# Future-climate stress scenario
client.weather_file(
    lat=33.45, lon=-112.07,
    ssp="ssp585", year=2090, percentile=90,
    uhi="urban",
    events="heatwave,hothumid",
    smoke=True, smoke_intensity=5,
    save_to="phoenix_2090_worst.epw",
)

# Per-model CMIP6 ensemble (Pro plan)
client.ensemble(lat=47.6, lon=-122.3, ssp="ssp245", year=2050,
                save_to_dir="seattle/")

Links

• Website: epwforge.com
• REST API docs: epwforge.com/docs
• MCP server: pypi.org/project/epwforge-mcp
• Maker: Guzzlabs

License

MIT