Tutorials¶

Use this page if you want the shortest learning path.

The full tutorial front door lives at ../tutorials/index.md. That page groups examples by functionality. This page keeps only the minimum path.

Use the minimal path to learn the core runtime loop. Use Track G later for operational surfaces like registries and composable pipelines.

First Visual Demo¶

Start here if you want to see Retriever doing something with a real sensor:

pixi run demo-webcam-detection

This opens the local webcam, runs a color detector, and displays detections through Rerun when available or stdout otherwise. Show red or blue objects to the camera. If no camera is available, run the tutorial module directly with --camera-mode mock.

Minimal API Path¶

Then run these in order to learn the core runtime mechanics:

pixi run demo-basic-flow
pixi run demo-adapter-connection
pixi run demo-rt-execution
pixi run demo-stepper
pixi run demo-webcam-record
pixi run demo-spatial-boundaries

What this path covers: - typed Flow and Pipeline authoring - adapters and execution surfaces - stepper debugging - .rrd / .mcap recording and replay - primitive-first typed boundaries

Choose By Functionality¶

Build a first pipeline: ../tutorials/track_a_flow_fundamentals.md
Run and inspect a backend: ../tutorials/track_b_ir_and_execution.md
Debug and replay failures: ../tutorials/track_c_debug_and_replay.md
Learn state and feedback patterns: ../tutorials/track_d_closed_loop_state_feedback.md
Learn synchronization and event joins: ../tutorials/track_e_resource_and_sync.md
Learn composition, registries, and type boundaries: ../tutorials/track_g_operations_interfaces.md
Learn release artifacts and acceptance gates: ../tutorials/track_h_release_readiness.md

Deep-Dives¶

Integrated walkthrough: ../tutorials/tutorial_integrated_debug_to_release.md
Lecture pack: ../tutorials/lectures/index.md