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

Object Detection

OpenVINO™ object detection on CPU, GPU and NPU

-

Yes

CPU and GPU

Wandering

Autonomous exploration and mapping in simulation

-

Yes

Yes

ITS Path Planner

ITS global planner for Nav2 in simulation

-

Yes

Yes

FastMapping

3D and 2D mapping from a recorded depth bag

-

Yes

Yes

Groundfloor Segmentation

Ground and obstacle segmentation from a recorded depth bag

-

Yes

With a workaround

ADBSCAN

Obstacle clustering from a recorded laser scan and point cloud

-

Yes

With a workaround

Collaborative SLAM

Two visual SLAM trackers with GPU feature extraction

-

Yes

Yes

RealSense™ Camera

A live RealSense™ camera through the camera interface

One RealSense™ camera

Yes

Yes

Multi-camera AI Demo

YOLOv8 on two RealSense™ cameras at once, on the GPU

Two RealSense™ cameras

Yes

Yes

Robotics System Profiler

ROS 2 KPIs in Grafana, monitoring another workshop

-

Yes

Yes

ROS 1 Bridge

A ROS 1 Noetic camera, ros1_bridge, and detection on Jazzy

-

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#

Getting Started

Install LXD and Workshop, check the GPU and NPU in a container, and launch your first suite workshop.

clickable cards
How Workshops Work

SDKs, device interfaces, Jazzy and Humble pairs, and how to add a workshop for another component.

clickable cards
ROS Distributions and Interoperability

Humble workshops, mixing Humble and Jazzy on one ROS domain, and reaching workshops from the host.

clickable cards
Troubleshooting

Fixes for device, display, proxy, storage and ROS problems in workshops.

clickable cards

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/.