Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,43 @@
+---
+language: en
+license: apache-2.0
+tags:
+  - energy
+  - synthetic-data
+  - AMI
+  - load-profiles
+  - new-england
+  - CVAE
+library_name: pytorch
+---
+
+# OpenSynth New England — CVAE Weights
+
+Conditional Variational Autoencoder for generating synthetic AMI load profiles
+conditioned on New England housing archetypes, heating fuel, weather, and DER.
+
+## Usage
+
+```python
+pip install opensynth-newengland[cvae]
+# Download weights to src/opensynth_ne/weights/
+from opensynth_ne import generate_day
+df, summary = generate_day(archetype="colonial", fuel="oil", month=0)
+```
+
+## Architecture
+
+- 948k parameters
+- 6-channel output: base, behav, heat, cool, ev, solar (96 timesteps each)
+- 32-dim latent space, 25-dim conditioning vector
+- Trained with cyclical beta annealing + free bits (0.5 nats/dim)
+
+## Training
+
+- 500k synthetic profiles from v0 mock model
+- 200 epochs, early stopped at 70
+- Val reconstruction MSE: 0.2225
+
+## Repository
+
+https://github.com/doctorbrownphd/opensynth-newengland