BioTwin-HIL

The Hardware-in-the-Loop physical-to-digital validation layer for biological signals.

1-Command Setup

To cold-boot the entire environment (Postgres, Redis, Rust Core, FastAPI Bio-Synths, and React Dashboard) from a fresh clone:

cd biotwin-hil
cp .env.example .env
# Edit .env to add your keys if necessary
./start.sh

Demo Steps (Under 4 Minutes)

1. Baseline Healthy Simulation

python run_hil.py --config virtual-hw/configs/normal_35m.json

Watch the TestMatrix turn green as the hardware successfully parses healthy rhythms (~75 BPM).

2. The Hardware Bug (Atrial Fibrillation)

python run_hil.py --config virtual-hw/configs/af_70m.json

Watch the physical Atrial Fibrillation waveform stream in the Wokwi visualizer. The firmware's fixed-threshold bug will undercount the rhythm, incorrectly reporting < 55 BPM. The TestMatrix will turn RED as the system catches the hardware failure.

3. Automated Threat Report

python generate_report.py --run af_70m

Streams the DeepSeek explainability report identifying the root-cause firmware bug.

4. Scaling Up

python run_hil.py --run-all-50-twins

Runs 50 parallel instances to validate massive-scale verification capabilities.

Stopping Services

To safely terminate all running background processes and Docker containers:

cd biotwin-hil
./stop.sh

Critical Documentation

• Demo Script: demo_script.md
• Recovery Plans: recovery_plans.md
• Firmware Bug Report: virtual-hw/firmware/demo_firmware_bug.md