Download
OpenWebHMI is still source-first. Pre-built gateway and designer installers come later; today the supported path is building and running the demo locally.
Prerequisites
- Rust — stable toolchain (pinned in
rust-toolchain.toml). Install via rustup ↗ - Node 20+ and pnpm 9+. pnpm install instructions ↗
- Python 3.11+ for the scripting host work in Phase 3.
- Tauri prerequisites for the desktop designer. Tauri docs ↗
- Raspberry Pi 4 / 5 with 64-bit Raspberry Pi OS Bookworm for edge gateway deployments. Pi deployment guide ↗
Build from source
git clone https://github.com/sergiogallegos/OpenWebHMI.git
cd OpenWebHMI
pnpm install
cargo build --workspace License and corresponding source
Product code is AGPL-3.0-only; the Rust and TypeScript wire-protocol packages are MPL-2.0. Official builds expose their exact Git commit and corresponding-source link in the Runtime or Designer Legal/Source area. Modified distributors must point to source matching their own build.
Run the current developer demo
Three terminals. After this, the runtime page shows a sin wave, a counter, and a Pressure value coming from the Rockwell-protocol simulator, all updating live. Killing the simulator flips the value to Bad quality; restarting it recovers automatically.
1 · Start the EtherNet/IP simulator
cargo run -p sim-rockwell -- --bind 127.0.0.1 --port 44818 2 · Start the gateway with the demo project
cargo run -p openwebhmi-gateway -- \
--project examples/projects/phase1-demo/project.toml 3 · Open the web runtime
pnpm --filter @openwebhmi/runtime-web dev
# Then open http://localhost:5173 Product-ready reference demo
The planned default bundle is a fictional manufacturing HMI that runs offline with deterministic simulated PLC data. An explicit real Rockwell profile will drive the same screens and logical tags from a physical PLC. Profile selection will be visible, and a failed PLC connection will not silently switch to simulation.
The first showcase is planned on Linux, with Omarchy as the initial recording environment—not an exclusive dependency, support guarantee, or official partnership.
Release packaging targets
These remain targets until release artifacts are built and smoke-tested. No installer is advertised as downloadable today.
- Gateway: standard artifacts for Linux, macOS, and Windows, plus a container image, after release validation.
- Designer: Tauri release artifacts for Linux, macOS, and Windows after each platform passes its installation and launch evidence gate.
Status reminder
OpenWebHMI is pre-alpha. It is not safety-rated, not a hard-real-time control platform, and not intended for production deployment in its current state. Real-hardware validation against a physical Rockwell PLC is a hard gate before tagging 1.0.