MiravoWhat Is Miravo?
Learn how Miravo simulates a factory from YAML, generates realistic industrial data, and exposes the same plant through real protocols.
Miravo (pronounced mih-RAH-voh) is an open-source factory simulator that generates realistic industrial data for whatever you're building.
You define assets once and run them as a factory with topology, wear and faults. The factory serves its live values over OPC UA, Modbus TCP and MQTT at the same time, as the plant it models would.
Why it exists
Software that runs on industrial data gets built against fake data. Real equipment is off-limits, failures can't be triggered on demand, and wear takes months to show up. So teams test against random tags and homemade scripts, and find the problems in production.
A simulated factory your software can connect to. Typed assets, a plant hierarchy, wear and cascading faults, ready before the real site is.
Who it is for
Teams building dashboards, historians, MES and OEE apps, UNS pipelines, SCADA and BMS integrations, edge and analytics platforms, and predictive maintenance. Also demos, CI tests and load tests.
What it provides
- Factories defined in YAML. Start from a template, write your own, or ask your agent: it builds, runs and changes the factory for you, so you never have to touch the YAML.
- Behavior beyond normal operation: equipment cycles, wear, part flow through lines, accelerated time, and faults that affect other assets. A press's air supply can follow a compressor's header pressure: in the Smart Factory template that binding is built in, so a compressor leak stops the press.
- The same live values through OPC UA, Modbus TCP and MQTT, with more to come.
- Seeded runs. The same template, seed, speed and tick give the same values, which suits CI.
- No license keys, no trial limits, no telemetry. The CLI checks GitHub Releases for updates once a day; set
MIRAVO_NO_UPDATE_CHECK=1to turn that off.
What a template is
A .miravo.yaml template composes asset models into a site layout, with live behavior and protocol settings.
Miravo ships with six built-in templates: Smart Factory, Water Treatment Plant, Commercial Building, Backup Power Facility, District Heating and Pharma Cleanroom. Start one as is, fork it, or build your own.
Limits
- Not for PLC logic testing, virtual commissioning, 3D visualization or throughput/layout optimization.
- Not physics-grade.
- No PackML.
- MQTT payloads are custom JSON, not Sparkplug B.
- Not for production use. Miravo is for development and testing, not operational control.
Where it fits
Miravo sits upstream of integrations and application code. Connect your stack to a running factory before the real site is available.
Integration workflow: Litmus Edge. Shell path: miravo le apply.
Next
Quick Start
Install, start a factory, connect your system.
Choose a template
Built-in templates and when to use each.
Litmus Edge
Map a running factory into Litmus Edge.
Miravo Core
Models, runtime and state.
AI Agents
Describe a plant in plain language and let your agent build and run it.
Was this page useful?
Last updated on