Metadata-Version: 2.4
Name: epwforge
Version: 0.0.1
Summary: 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.
Project-URL: Homepage, https://epwforge.com
Project-URL: Repository, https://github.com/guzz-labs/epwforge-py
Project-URL: Issues, https://github.com/guzz-labs/epwforge-py/issues
Author-email: Guzzlabs <tuna@guzzlabs.com>
License: MIT
License-File: LICENSE
Keywords: amy,building-energy-modeling,building-energy-simulation,climate-adaptation,climate-deltas,climate-resilience,cmip6,cold-snap,compound-events,custom-weather-file,ddy,energyplus,epw,epwforge,equest,era5,extreme-events,guzzlabs,heat-wave,honeybee,ies-ve,ipcc-ar6,ladybug,openstudio,ssp,tmy,tmyx,uhi,urban-heat-island,weather-file,weather-morphing,wildfire-smoke
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# epwforge

> Python client for [EPWForge](https://epwforge.com) — 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](https://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:

```python
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](https://epwforge.com)
- **REST API docs:** [epwforge.com/docs](https://epwforge.com/docs)
- **MCP server:** [pypi.org/project/epwforge-mcp](https://pypi.org/project/epwforge-mcp)
- **Maker:** [Guzzlabs](https://guzzlabs.com)

## License

MIT
