Living architecture wiki

Involve Sim Engine

A cloud-agnostic, real-time engine for immersive healthcare training simulations — where clinicians, learners, and AI agents share audio, video, and data in a live room.

Iteration

1

Infrastructure

Clouds live

2

Azure + GCP

Provisioning

IaC

Pulumi / TypeScript

Media

LiveKit

Self-hosted WebRTC

What this is

The Involve Sim Engine powers multi-participant training scenarios. A room is the hub of a session: humans join from a browser, and AI agents join the same room to drive or observe the scenario. Everything — voice, video, and structured data — flows through that room in real time.

We chose LiveKit (a self-hosted, open-source WebRTC stack) as the realtime layer, and we provision it entirely as code so the exact same design can land on any cloud.

Principles

Cloud-agnostic

One codebase, deployed identically to Azure and GCP. Provider wiring is the only thing that differs.

Realtime-first

Sub-second audio, video, and data via a self-hosted SFU with embedded TURN for restrictive networks.

Secure by default

Automatic TLS, scoped secrets, and DNS decoupled from any single provider.

Infrastructure as code

Reproducible Pulumi stacks — no console clicking, every change reviewable.

Human + AI rooms

Designed so AI agents are first-class participants alongside people.

Evolvable

This wiki and the eventual web client live in one React Router app that grows with the product.

How to read this wiki

The Architecture section covers how a session fits together and how we host it. The Operations section captures how we verify the system and the decisions we've made along the way. It's a living document — it grows as the engine does.