Skip to content

Getting Started

Start leveraging the advantages of Behavior Trees 🌳 fully integrated with ROS 2 🤖.

NOTE

Currently we support Linux only!.

ROS 2Build & Test
Jazzy JaliscoJazzy
Kilted KaijuKilted
Rolling RidleyRolling

Run your first Behavior

The following installation guide helps you getting started with AutoAPMS.

  1. Create a ROS 2 workspace and clone this repository

    bash
    mkdir ros2_ws && cd ros2_ws
    (mkdir src && cd src && git clone https://github.com/AutoAPMS/auto-apms.git)
  2. Install all required dependencies. We assume that you already installed ROS 2 on your system

    bash
    rosdep init  # Skip this if rosdep has already been initialized
    rosdep update
    rosdep install --from-paths src --ignore-src -y
  3. Build and install all packages required for auto_apms_examples

    bash
    colcon build --packages-up-to auto_apms_examples --symlink-install
  4. Run your first behavior using ros2 behavior. This is an extension of the ROS 2 CLI introduced by the auto_apms_ros2behavior package

    bash
    source install/setup.bash
    ros2 behavior run auto_apms_examples::demo::HelloWorld --blackboard name:=Turtle

    auto-apms-gif

Visual Demonstration

We provide a guide for running a cool visual demonstration on complex behaviors created with AutoAPMS in the auto_apms_simulation repository. The simulation shows multiple "robots" moving in a magical hall adjusting their behavior dynamically according to the following policy: Approach the goal as long as the hallway is not occupied - if it is, retreat. Piertotum Locomotor!

Released under the Apache-2.0 License.