Full-stack real-time telemetry platform for public Hyperloop demos. Captures live packet data and visualizes system state via SSE streaming.
Table of Contents
Hypervisor is a full-stack real-time telemetry and visualization platform developed at Hyperloop UPV for public demonstrations.
The backend, written in Go, captures live network packets from the vehicle infrastructure, processes them into structured domain state, and streams real-time updates via Server-Sent Events (SSE).
The frontend, built with React, consumes these event streams and renders a responsive, read-only visualization of the system during live demos. This allows audiences to observe real-time system behaviour without interfering with operational control.
The architecture emphasizes determinism, reliability, and a strict separation between control and observation to ensure stable performance under live event conditions.
This section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.
To get a local copy up and running follow these simple example steps.
- Node.js >= v25.6.1
- npm >= 11.10.1
- libpcap >= 2.77
- go >= 1.23.0
Below is an example of how you can instruct your audience on installing and setting up your app. This template doesn't rely on any external dependencies or services.
- Clone the repo
git clone https://github.com/Hyperloop-UPV/Hyperloop.git
- Install NPM packages of frontend
cd frontend && npm install
- Run frontend
npm run dev # at frontend/ - Install Go dependencies
cd backend/ && go mod tidy
- Run backend
cd cmd && sudo go run
Hypervisor is built to be used in a Linux OS
- Download latest release and unzip it
- Run preconfiguration script
sudo ./setup_hypervisor.sh - Run hypervisor
sudo ./hypervisor
- Javier Ribal del Río - Backend & Network
- Lola Castelló Puchades - Frontend
Distributed under the GNU GENERAL PUBLIC LICENSE. See LICENSE for more information.
Made at Hyperloop UPV