Canonical Workshop Environments#
Canonical Workshop creates reproducible development environments as LXD system containers. The Robotics AI Suite provides a Workshop definition for each component: one command creates a container with the suite and that component installed, and passes the host’s Intel® GPU, Intel® NPU, cameras and desktop through to it.
Use workshops to:
Try a component without installing the suite on the host.
Run ROS 2 Jazzy (Ubuntu 24.04) and ROS 2 Humble (Ubuntu 22.04) side by side on one Ubuntu 24.04 host.
Connect a ROS 1 Noetic application to the suite through
ros1_bridge.Keep each component’s dependencies separate, and rebuild an environment from scratch at any time.
Inference in a workshop runs at the same speed as on the host: in the Object Detection tutorial, OpenVINO™ throughput in the workshop was within run-to-run variation of the host’s on the CPU, GPU and NPU.
Available workshops#
Every ROS 2 workshop has a Jazzy definition, <name>, and a Humble definition, <name>-humble.
Tutorial |
What it runs |
Extra hardware |
Jazzy |
Humble |
|---|---|---|---|---|
OpenVINO™ object detection on CPU, GPU and NPU |
- |
Yes |
CPU and GPU |
|
Autonomous exploration and mapping in simulation |
- |
Yes |
Yes |
|
ITS global planner for Nav2 in simulation |
- |
Yes |
Yes |
|
3D and 2D mapping from a recorded depth bag |
- |
Yes |
Yes |
|
Ground and obstacle segmentation from a recorded depth bag |
- |
Yes |
With a workaround |
|
Obstacle clustering from a recorded laser scan and point cloud |
- |
Yes |
With a workaround |
|
Two visual SLAM trackers with GPU feature extraction |
- |
Yes |
Yes |
|
A live RealSense™ camera through the camera interface |
One RealSense™ camera |
Yes |
Yes |
|
YOLOv8 on two RealSense™ cameras at once, on the GPU |
Two RealSense™ cameras |
Yes |
Yes |
|
ROS 2 KPIs in Grafana, monitoring another workshop |
- |
Yes |
Yes |
|
A ROS 1 Noetic camera, |
- |
Yes |
- |
All workshops were tested on an Intel® Core™ Ultra X7 358H processor with Intel® Arc™ B390 graphics and robotics-installer v2026.3.12. The results in these tutorials are examples from that system.
Note
Individual results may vary.
Where to start#
Install LXD and Workshop, check the GPU and NPU in a container, and launch your first suite workshop.
SDKs, device interfaces, Jazzy and Humble pairs, and how to add a workshop for another component.
Humble workshops, mixing Humble and Jazzy on one ROS domain, and reaching workshops from the host.
Fixes for device, display, proxy, storage and ROS problems in workshops.
The workshop definitions are in the repository next to each component’s source, in src/components/<component>/workshop/. The shared parts, and the workshops without a component of their own, are in src/workshops/.