Orchestration system for Physical AI — multi-camera RTSP streaming with ROS-Z and real-time browser visualization.
curl -sSL https://github.com/kornia/bubbaloop/releases/latest/download/install.sh | bashnpm install -g @kornia-ai/bubbaloopbubbaloopRequirements: Linux (x86_64 or ARM64), Node.js 20+
The install script sets up systemd services:
| Service | Description |
|---|---|
zenohd |
Zenoh router for pub/sub messaging |
zenoh-bridge |
WebSocket bridge for browser access |
bubbaloop-daemon |
Node manager for starting/stopping nodes |
The npm package provides the bubbaloop CLI for managing nodes.
For building from source:
git clone https://github.com/kornia/bubbaloop.git
cd bubbaloop
pixi install
pixi run upThis launches the zenoh bridge, camera streams, and dashboard using process-compose.
Dashboard: http://localhost:5173
pixi run daemon # Start daemon
pixi run bubbaloop # Start terminal UI
pixi run dashboard # Start web dashboard
pixi run cameras # Start camera streams# View status
systemctl --user status bubbaloop-daemon
# Restart
systemctl --user restart bubbaloop-daemon
# View logs
journalctl --user -u bubbaloop-daemon -fFor detailed documentation, run:
pixi run docsOr see the docs/ directory.
