Home

Welcome to the vpp-sim wiki.

This project simulates a small C&I site-scale Virtual Power Plant (VPP) in fast-forwarded, discrete timesteps. It models DER dispatch, flexible demand, feeder constraints, and demand response events under an aggregator control loop.

Start Here

• Glossary
• Architecture
• Scenario Format (TOML)
• Controller Behavior
• Telemetry & KPIs
• HTTP API
• Contributing & Development

Project Scope

vpp-sim currently focuses on:

• On-site solar PV
• Battery dispatch with SoC tracking
• Flexible demand (for example EV charging profiles)
• Inflexible baseline demand
• DR event windows and curtailment
• Feeder import/export limits
• Timestep telemetry and end-of-run KPI summaries

Quick Run

cargo run --release -- --preset demo

Run with CSV telemetry:

cargo run --release -- --preset demo --telemetry-out telemetry.csv

Run with API enabled:

cargo run --release -- --preset demo --api-bind 127.0.0.1:8080