PyTrees for ROS

November 13, 2025 ยท View on GitHub

Behaviours, trees, and utilities that extend PyTrees for use with ROS.

Trees

Getting Started

Choose your ROS distro and install via debians, e.g., for Jazzy:

$ sudo apt install \
    ros-jazzy-py-trees \
    ros-jazzy-py-trees-ros-interfaces \
    ros-jazzy-py-trees-ros \
    ros-jazzy-py-trees-ros-tutorials \
    ros-jazzy-py-trees-ros-viewer

Dive into the PyTrees Docs for a basic primer (non-ROS) on behaviour trees, then move on to the PyTrees ROS Tutorials which incrementally build a scenario for a robot. The PyTrees ROS documentation provides API docs for ROS specific trees, idioms, and behaviours respectively.

For version specific releases of the documentation, refer to the documentation links in the matrix below.

ROS DistroRollingKiltedJazzyHumble
py_trees2.4.x
Build Status
2.4.x-Docs
2.4.x
Build Status
2.4.x-Docs
2.4.x
Build Status
2.4.x-Docs
2.4.x
Build Status
2.4.x-Docs
py_trees_ros_interfaces2.1.x
Build Status
2.1.x
Build Status
2.1.x
Build Status
2.1.x
Build Status
py_trees_ros2.4.x
Build Status
2.4.x-Docs
2.4.x
Build Status
2.4.x-Docs
2.4.x
Build Status
2.4.x-Docs
2.4.x
Build Status
2.4.x-Docs
py_trees_ros_tutorials2.4.x
Build Status
2.4.x-Docs
2.4.x
Build Status
2.4.x-Docs
2.4.x
Build Status
2.4.x-Docs
2.4.x
Build Status
2.4.x-Docs
py_trees_js0.6.x
Build Status
0.6.x-Docs
0.6.x
Build Status
0.6.x-Docs
0.6.x
Build Status
0.6.x-Docs
0.6.x
Build Status
0.6.x-Docs
py_trees_ros_viewer0.2.x
Build Status
0.2.x-Docs
0.2.x
Build Status
0.2.x-Docs
0.2.x
Build Status
0.2.x-Docs
0.2.x
Build Status
0.2.x-Docs