Tutorials

Step-by-step guides that teach robotics concepts by building real, runnable applications with HORUS. Each tutorial builds a complete working application. Follow them in order — each one builds on concepts from the previous.

Rust Learning Path

#TutorialWhat You'll BuildWhat You'll Learn
1Quick StartTemperature sensor + monitorNode, Topic, Scheduler basics
2Sensor Pipeline3-node sensor → filter → displayMulti-node architecture, message flow
3IMU Sensor NodeIMU data publisher at 100HzCustom data types, .hz(), sensor patterns
4Motor ControllerVelocity → position controllerSubscribing, state management, safe shutdown
5Full Robot Integration4-node robot systemMulti-rate scheduling, data fusion, monitoring
6Custom Message TypesBattery monitor with custom messagesmessage! macro, manual derives, GenericMessage
7Hardware DriversServo bus + custom conveyor driverhorus.toml [hardware], NodeParams, register_driver!
8Real-Time ControlHard-RT motor + lidar + planner.rate(), .budget(), .on_miss(), .failure_policy(), .compute()
9Debug with Record & ReplayRecord a bug, replay, fix with mixed replay.with_recording(), replay_from(), inject, diff
10Choosing ConfigurationProgressive config levelsRate, budget, deadline, safety
11Common Mistakes13 pitfalls and how to avoid them

Python Tutorials

The same progression, using the Python API:

#TutorialWhat You'll Build
1Quick Start (Python)Temperature sensor + monitor
2IMU Sensor Node (Python)IMU data publisher at 100Hz
3Motor Controller (Python)Velocity → position controller with safe shutdown
4Full Robot System (Python)4-node robot with multi-rate scheduling
5Custom Messages (Python)Typed messages, dicts, dataclasses
6Hardware & Real-Time (Python)Drivers, budgets, deadlines, production config

Prerequisites


See Also