Hosts
Universal Data Generator ships four hosts. Each one acquires a run configuration, hands it to the Core engine, and reports progress. None of them reimplements scheduling, value generation, or target writes.
PowerShell module
A binary cmdlet module. It exports two cmdlets.
| Cmdlet | Purpose |
|---|---|
Import-UniDataGenCatalog |
Writes the embedded catalog to the pipeline. |
Start-UniDataGenRun |
Runs a configuration until stopped with Ctrl-C. |
Import-Module ./hosts/UniDataGen.PowerShell/bin/Debug/net10.0/UniDataGen.PowerShell.dll
Start-UniDataGenRun -ConfigPath ./run-config.json -Offline -Verbose
| Parameter | Description |
|---|---|
-ConfigPath |
Path to the run configuration. |
-TickSeconds |
The engine tick interval. Defaults to 2. |
-Offline |
Skips Foundry and uses placeholder values. |
-AppInsightsConnectionString |
Routes logs to Application Insights. |
Azure Functions host
An isolated worker. The GeneratorTimer function runs a bounded generation pass on a timer. It
reads the run-config path from app settings. The catalog is embedded.
| App setting | Purpose |
|---|---|
DATAGEN_CONFIG |
Path to the run configuration. |
DATAGEN_OFFLINE |
true to skip Foundry. |
APPLICATIONINSIGHTS_CONNECTION_STRING |
Application Insights connection string. |
Note: The timer drives batch cadence. For continuous real-time generation that must survive host recycles, promote the timer function to a Durable Functions orchestration. See Architecture overview.
WinForms client
A desktop client for Windows. It loads the embedded catalog into pick lists, builds each entity profile through a grid, previews boost ramp curves, selects targets, and runs locally or saves the run configuration. The toolbar has a field for the Application Insights connection string, and the log box mirrors every structured log line.
Configuration editor
UniDataGen.ConfigEditor is a Windows desktop application for editing the run configuration through a property grid.
It reads and writes the same run-config JSON the other hosts consume, and keeps its reference lists and
preferences in local JSON files. See Configuration editor.
Foundry agent tool
A console wrapper that exposes the engine as a single callable operation for an Azure AI Foundry agent. The function schema is in hosts/UniDataGen.Foundry.Tool/tool-manifest.json.
UniDataGen.Foundry.Tool ./run-config.json --offline --seconds 30