ROS index logo ROS Index
  1. Home
  2. Packages
  3. moveit2_tutorials
 
No version for distro humble showing github. Known supported distros are highlighted in the buttons above.
Package symbol

moveit2_tutorials package from moveit2_tutorials repo

moveit2_tutorials

ROS Distro
github

API Docs
Browse Code

Package Summary

Tags No category tags.
Version 0.1.0
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description A sphinx-based centralized documentation repo for MoveIt 2
Checkout URI https://github.com/moveit/moveit2_tutorials.git
VCS Type git
VCS Version main
Last Updated 2025-06-29
Dev Status UNKNOWN
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

The moveit2_tutorials package

Additional Links

Maintainers

  • Dave Coleman
  • Mike Lautman

Authors

  • Sachin Chitta
  • Dave Coleman
  • Mike Lautman
README.md

MoveIt Tutorials

Live tutorials here

This is the primary documentation for the MoveIt project.

Build Status

This repository is built and deployed automatically by GitHub Actions:

  • Rolling (main): CI Format Deploy
  • Humble: CI Format Deploy

Contributing

We strongly encourage you to help improve MoveIt’s documentation. Please consider helping improve the tutorials, port old ones from ROS 1, and write new tutorials. We recommend you read the quality standards below as well as the How to Write a MoveIt Tutorial page.

If you find an issue with the tutorials you are not able to fix yourself, please open an issue on GitHub or open a PR with proposed changes.

Helping with Porting Tutorials to ROS 2

An issue has been created for each tutorial to be ported to ROS 2. At the top of each tutorial, there is a tag: “:moveit1:”, remove the tag after the tutorial has been successfully updated.

Below are some links to help with the ports.

MoveIt Tutorials Source Build

Follow the MoveIt Source Build instructions to set up a colcon workspace with MoveIt from the source.

Open a command line to your colcon workspace:

cd $COLCON_WS/src

Download the MoveIt Tutorials source code:

git clone https://github.com/moveit/moveit2_tutorials.git
vcs import < moveit2_tutorials/moveit2_tutorials.repos
rosdep install -r --from-paths . --ignore-src --rosdistro rolling -y

Configure and build the workspace:

cd $COLCON_WS
colcon build --event-handlers desktop_notification- status- --cmake-args -DCMAKE_BUILD_TYPE=Release

Build HTML Pages Locally

If you want to test the tutorials by generating the HTML pages locally on your machine, you can use the build_locally.sh script in this repo.

If you are using Ubuntu 24.04 (or Python 3.11 or greater), you should first create a virtual environment.

python3 -m venv .venv
source .venv/bin/activate

Then, issue the following commands in the root of the moveit2_tutorials package:

cd $COLCON_WS/src/moveit2_tutorials

export ROS_DISTRO=rolling  # 24.04
source /opt/ros/$ROS_DISTRO/setup.bash

./build_locally.sh

The local website <LOCAL_PACKAGE_PATH>/build/html/index.html should automatically open in your web browser.

Optional build_locally Settings

  • noinstall skip the dependencies install step to speed up the script
  • loop automatically rebuilds the HTML if a change is detected

Formatting and Style

These tutorials use the reStructuredText format commonly used in the Sphinx “Python Documentation Generator”. This unfortunately differs from the common Markdown format, but its advantage is that it supports embedding code directly from source files for inline code tutorials.

Code Formatting

  • These tutorials use the same style guidelines as the MoveIt project. When modifying or adding to these tutorials, it is required that code is auto-formatted using clang format. To check and apply the style guidelines we use pre-commit.
  • Tutorials should exemplify best coding practices. If a contribution wouldn’t pass review in the MoveIt project, then it shouldn’t pass review in the tutorials.
  • Relevant code should be included and explained using the .. tutorial-formatter:: tag.
  • Irrelevant code should be excluded from the generated HTML using the BEGIN_TUTORIAL, END_TUTORIAL, BEGIN_SUB_TUTORIAL, and END_SUB_TUTORIAL tags.
  • Whenever possible, links should be created using the extlinks dictionary defined in conf.py.
  • All demo code should be runnable from within the moveit2_tutorials package.
  • Python code should be run using ros2 run.

Style

  • Each tutorial should be focused on teaching the user one feature or interface within MoveIt.
  • Tutorials should flow from show to tell with videos and demos at the beginning followed by explanations.
  • New tutorials should match the formatting, style, and flow of existing tutorials whenever possible.

pre-commit

pre-commit is a tool that is used in moveit2_tutorials to check and apply style guidelines automatically. To install pre-commit into your system:

pip3 install pre-commit

Then under the moveit2_tutorials directory install the git hooks like this:

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Recent questions tagged moveit2_tutorials at Robotics Stack Exchange

No version for distro jazzy showing github. Known supported distros are highlighted in the buttons above.
Package symbol

moveit2_tutorials package from moveit2_tutorials repo

moveit2_tutorials

ROS Distro
github

API Docs
Browse Code

Package Summary

Tags No category tags.
Version 0.1.0
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description A sphinx-based centralized documentation repo for MoveIt 2
Checkout URI https://github.com/moveit/moveit2_tutorials.git
VCS Type git
VCS Version main
Last Updated 2025-06-29
Dev Status UNKNOWN
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

The moveit2_tutorials package

Additional Links

Maintainers

  • Dave Coleman
  • Mike Lautman

Authors

  • Sachin Chitta
  • Dave Coleman
  • Mike Lautman
README.md

MoveIt Tutorials

Live tutorials here

This is the primary documentation for the MoveIt project.

Build Status

This repository is built and deployed automatically by GitHub Actions:

  • Rolling (main): CI Format Deploy
  • Humble: CI Format Deploy

Contributing

We strongly encourage you to help improve MoveIt’s documentation. Please consider helping improve the tutorials, port old ones from ROS 1, and write new tutorials. We recommend you read the quality standards below as well as the How to Write a MoveIt Tutorial page.

If you find an issue with the tutorials you are not able to fix yourself, please open an issue on GitHub or open a PR with proposed changes.

Helping with Porting Tutorials to ROS 2

An issue has been created for each tutorial to be ported to ROS 2. At the top of each tutorial, there is a tag: “:moveit1:”, remove the tag after the tutorial has been successfully updated.

Below are some links to help with the ports.

MoveIt Tutorials Source Build

Follow the MoveIt Source Build instructions to set up a colcon workspace with MoveIt from the source.

Open a command line to your colcon workspace:

cd $COLCON_WS/src

Download the MoveIt Tutorials source code:

git clone https://github.com/moveit/moveit2_tutorials.git
vcs import < moveit2_tutorials/moveit2_tutorials.repos
rosdep install -r --from-paths . --ignore-src --rosdistro rolling -y

Configure and build the workspace:

cd $COLCON_WS
colcon build --event-handlers desktop_notification- status- --cmake-args -DCMAKE_BUILD_TYPE=Release

Build HTML Pages Locally

If you want to test the tutorials by generating the HTML pages locally on your machine, you can use the build_locally.sh script in this repo.

If you are using Ubuntu 24.04 (or Python 3.11 or greater), you should first create a virtual environment.

python3 -m venv .venv
source .venv/bin/activate

Then, issue the following commands in the root of the moveit2_tutorials package:

cd $COLCON_WS/src/moveit2_tutorials

export ROS_DISTRO=rolling  # 24.04
source /opt/ros/$ROS_DISTRO/setup.bash

./build_locally.sh

The local website <LOCAL_PACKAGE_PATH>/build/html/index.html should automatically open in your web browser.

Optional build_locally Settings

  • noinstall skip the dependencies install step to speed up the script
  • loop automatically rebuilds the HTML if a change is detected

Formatting and Style

These tutorials use the reStructuredText format commonly used in the Sphinx “Python Documentation Generator”. This unfortunately differs from the common Markdown format, but its advantage is that it supports embedding code directly from source files for inline code tutorials.

Code Formatting

  • These tutorials use the same style guidelines as the MoveIt project. When modifying or adding to these tutorials, it is required that code is auto-formatted using clang format. To check and apply the style guidelines we use pre-commit.
  • Tutorials should exemplify best coding practices. If a contribution wouldn’t pass review in the MoveIt project, then it shouldn’t pass review in the tutorials.
  • Relevant code should be included and explained using the .. tutorial-formatter:: tag.
  • Irrelevant code should be excluded from the generated HTML using the BEGIN_TUTORIAL, END_TUTORIAL, BEGIN_SUB_TUTORIAL, and END_SUB_TUTORIAL tags.
  • Whenever possible, links should be created using the extlinks dictionary defined in conf.py.
  • All demo code should be runnable from within the moveit2_tutorials package.
  • Python code should be run using ros2 run.

Style

  • Each tutorial should be focused on teaching the user one feature or interface within MoveIt.
  • Tutorials should flow from show to tell with videos and demos at the beginning followed by explanations.
  • New tutorials should match the formatting, style, and flow of existing tutorials whenever possible.

pre-commit

pre-commit is a tool that is used in moveit2_tutorials to check and apply style guidelines automatically. To install pre-commit into your system:

pip3 install pre-commit

Then under the moveit2_tutorials directory install the git hooks like this:

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Recent questions tagged moveit2_tutorials at Robotics Stack Exchange

No version for distro kilted showing github. Known supported distros are highlighted in the buttons above.
Package symbol

moveit2_tutorials package from moveit2_tutorials repo

moveit2_tutorials

ROS Distro
github

API Docs
Browse Code

Package Summary

Tags No category tags.
Version 0.1.0
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description A sphinx-based centralized documentation repo for MoveIt 2
Checkout URI https://github.com/moveit/moveit2_tutorials.git
VCS Type git
VCS Version main
Last Updated 2025-06-29
Dev Status UNKNOWN
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

The moveit2_tutorials package

Additional Links

Maintainers

  • Dave Coleman
  • Mike Lautman

Authors

  • Sachin Chitta
  • Dave Coleman
  • Mike Lautman
README.md

MoveIt Tutorials

Live tutorials here

This is the primary documentation for the MoveIt project.

Build Status

This repository is built and deployed automatically by GitHub Actions:

  • Rolling (main): CI Format Deploy
  • Humble: CI Format Deploy

Contributing

We strongly encourage you to help improve MoveIt’s documentation. Please consider helping improve the tutorials, port old ones from ROS 1, and write new tutorials. We recommend you read the quality standards below as well as the How to Write a MoveIt Tutorial page.

If you find an issue with the tutorials you are not able to fix yourself, please open an issue on GitHub or open a PR with proposed changes.

Helping with Porting Tutorials to ROS 2

An issue has been created for each tutorial to be ported to ROS 2. At the top of each tutorial, there is a tag: “:moveit1:”, remove the tag after the tutorial has been successfully updated.

Below are some links to help with the ports.

MoveIt Tutorials Source Build

Follow the MoveIt Source Build instructions to set up a colcon workspace with MoveIt from the source.

Open a command line to your colcon workspace:

cd $COLCON_WS/src

Download the MoveIt Tutorials source code:

git clone https://github.com/moveit/moveit2_tutorials.git
vcs import < moveit2_tutorials/moveit2_tutorials.repos
rosdep install -r --from-paths . --ignore-src --rosdistro rolling -y

Configure and build the workspace:

cd $COLCON_WS
colcon build --event-handlers desktop_notification- status- --cmake-args -DCMAKE_BUILD_TYPE=Release

Build HTML Pages Locally

If you want to test the tutorials by generating the HTML pages locally on your machine, you can use the build_locally.sh script in this repo.

If you are using Ubuntu 24.04 (or Python 3.11 or greater), you should first create a virtual environment.

python3 -m venv .venv
source .venv/bin/activate

Then, issue the following commands in the root of the moveit2_tutorials package:

cd $COLCON_WS/src/moveit2_tutorials

export ROS_DISTRO=rolling  # 24.04
source /opt/ros/$ROS_DISTRO/setup.bash

./build_locally.sh

The local website <LOCAL_PACKAGE_PATH>/build/html/index.html should automatically open in your web browser.

Optional build_locally Settings

  • noinstall skip the dependencies install step to speed up the script
  • loop automatically rebuilds the HTML if a change is detected

Formatting and Style

These tutorials use the reStructuredText format commonly used in the Sphinx “Python Documentation Generator”. This unfortunately differs from the common Markdown format, but its advantage is that it supports embedding code directly from source files for inline code tutorials.

Code Formatting

  • These tutorials use the same style guidelines as the MoveIt project. When modifying or adding to these tutorials, it is required that code is auto-formatted using clang format. To check and apply the style guidelines we use pre-commit.
  • Tutorials should exemplify best coding practices. If a contribution wouldn’t pass review in the MoveIt project, then it shouldn’t pass review in the tutorials.
  • Relevant code should be included and explained using the .. tutorial-formatter:: tag.
  • Irrelevant code should be excluded from the generated HTML using the BEGIN_TUTORIAL, END_TUTORIAL, BEGIN_SUB_TUTORIAL, and END_SUB_TUTORIAL tags.
  • Whenever possible, links should be created using the extlinks dictionary defined in conf.py.
  • All demo code should be runnable from within the moveit2_tutorials package.
  • Python code should be run using ros2 run.

Style

  • Each tutorial should be focused on teaching the user one feature or interface within MoveIt.
  • Tutorials should flow from show to tell with videos and demos at the beginning followed by explanations.
  • New tutorials should match the formatting, style, and flow of existing tutorials whenever possible.

pre-commit

pre-commit is a tool that is used in moveit2_tutorials to check and apply style guidelines automatically. To install pre-commit into your system:

pip3 install pre-commit

Then under the moveit2_tutorials directory install the git hooks like this:

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Recent questions tagged moveit2_tutorials at Robotics Stack Exchange

No version for distro rolling showing github. Known supported distros are highlighted in the buttons above.
Package symbol

moveit2_tutorials package from moveit2_tutorials repo

moveit2_tutorials

ROS Distro
github

API Docs
Browse Code

Package Summary

Tags No category tags.
Version 0.1.0
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description A sphinx-based centralized documentation repo for MoveIt 2
Checkout URI https://github.com/moveit/moveit2_tutorials.git
VCS Type git
VCS Version main
Last Updated 2025-06-29
Dev Status UNKNOWN
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

The moveit2_tutorials package

Additional Links

Maintainers

  • Dave Coleman
  • Mike Lautman

Authors

  • Sachin Chitta
  • Dave Coleman
  • Mike Lautman
README.md

MoveIt Tutorials

Live tutorials here

This is the primary documentation for the MoveIt project.

Build Status

This repository is built and deployed automatically by GitHub Actions:

  • Rolling (main): CI Format Deploy
  • Humble: CI Format Deploy

Contributing

We strongly encourage you to help improve MoveIt’s documentation. Please consider helping improve the tutorials, port old ones from ROS 1, and write new tutorials. We recommend you read the quality standards below as well as the How to Write a MoveIt Tutorial page.

If you find an issue with the tutorials you are not able to fix yourself, please open an issue on GitHub or open a PR with proposed changes.

Helping with Porting Tutorials to ROS 2

An issue has been created for each tutorial to be ported to ROS 2. At the top of each tutorial, there is a tag: “:moveit1:”, remove the tag after the tutorial has been successfully updated.

Below are some links to help with the ports.

MoveIt Tutorials Source Build

Follow the MoveIt Source Build instructions to set up a colcon workspace with MoveIt from the source.

Open a command line to your colcon workspace:

cd $COLCON_WS/src

Download the MoveIt Tutorials source code:

git clone https://github.com/moveit/moveit2_tutorials.git
vcs import < moveit2_tutorials/moveit2_tutorials.repos
rosdep install -r --from-paths . --ignore-src --rosdistro rolling -y

Configure and build the workspace:

cd $COLCON_WS
colcon build --event-handlers desktop_notification- status- --cmake-args -DCMAKE_BUILD_TYPE=Release

Build HTML Pages Locally

If you want to test the tutorials by generating the HTML pages locally on your machine, you can use the build_locally.sh script in this repo.

If you are using Ubuntu 24.04 (or Python 3.11 or greater), you should first create a virtual environment.

python3 -m venv .venv
source .venv/bin/activate

Then, issue the following commands in the root of the moveit2_tutorials package:

cd $COLCON_WS/src/moveit2_tutorials

export ROS_DISTRO=rolling  # 24.04
source /opt/ros/$ROS_DISTRO/setup.bash

./build_locally.sh

The local website <LOCAL_PACKAGE_PATH>/build/html/index.html should automatically open in your web browser.

Optional build_locally Settings

  • noinstall skip the dependencies install step to speed up the script
  • loop automatically rebuilds the HTML if a change is detected

Formatting and Style

These tutorials use the reStructuredText format commonly used in the Sphinx “Python Documentation Generator”. This unfortunately differs from the common Markdown format, but its advantage is that it supports embedding code directly from source files for inline code tutorials.

Code Formatting

  • These tutorials use the same style guidelines as the MoveIt project. When modifying or adding to these tutorials, it is required that code is auto-formatted using clang format. To check and apply the style guidelines we use pre-commit.
  • Tutorials should exemplify best coding practices. If a contribution wouldn’t pass review in the MoveIt project, then it shouldn’t pass review in the tutorials.
  • Relevant code should be included and explained using the .. tutorial-formatter:: tag.
  • Irrelevant code should be excluded from the generated HTML using the BEGIN_TUTORIAL, END_TUTORIAL, BEGIN_SUB_TUTORIAL, and END_SUB_TUTORIAL tags.
  • Whenever possible, links should be created using the extlinks dictionary defined in conf.py.
  • All demo code should be runnable from within the moveit2_tutorials package.
  • Python code should be run using ros2 run.

Style

  • Each tutorial should be focused on teaching the user one feature or interface within MoveIt.
  • Tutorials should flow from show to tell with videos and demos at the beginning followed by explanations.
  • New tutorials should match the formatting, style, and flow of existing tutorials whenever possible.

pre-commit

pre-commit is a tool that is used in moveit2_tutorials to check and apply style guidelines automatically. To install pre-commit into your system:

pip3 install pre-commit

Then under the moveit2_tutorials directory install the git hooks like this:

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Recent questions tagged moveit2_tutorials at Robotics Stack Exchange

Package symbol

moveit2_tutorials package from moveit2_tutorials repo

moveit2_tutorials

ROS Distro
github

API Docs
Browse Code

Package Summary

Tags No category tags.
Version 0.1.0
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description A sphinx-based centralized documentation repo for MoveIt 2
Checkout URI https://github.com/moveit/moveit2_tutorials.git
VCS Type git
VCS Version main
Last Updated 2025-06-29
Dev Status UNKNOWN
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

The moveit2_tutorials package

Additional Links

Maintainers

  • Dave Coleman
  • Mike Lautman

Authors

  • Sachin Chitta
  • Dave Coleman
  • Mike Lautman
README.md

MoveIt Tutorials

Live tutorials here

This is the primary documentation for the MoveIt project.

Build Status

This repository is built and deployed automatically by GitHub Actions:

  • Rolling (main): CI Format Deploy
  • Humble: CI Format Deploy

Contributing

We strongly encourage you to help improve MoveIt’s documentation. Please consider helping improve the tutorials, port old ones from ROS 1, and write new tutorials. We recommend you read the quality standards below as well as the How to Write a MoveIt Tutorial page.

If you find an issue with the tutorials you are not able to fix yourself, please open an issue on GitHub or open a PR with proposed changes.

Helping with Porting Tutorials to ROS 2

An issue has been created for each tutorial to be ported to ROS 2. At the top of each tutorial, there is a tag: “:moveit1:”, remove the tag after the tutorial has been successfully updated.

Below are some links to help with the ports.

MoveIt Tutorials Source Build

Follow the MoveIt Source Build instructions to set up a colcon workspace with MoveIt from the source.

Open a command line to your colcon workspace:

cd $COLCON_WS/src

Download the MoveIt Tutorials source code:

git clone https://github.com/moveit/moveit2_tutorials.git
vcs import < moveit2_tutorials/moveit2_tutorials.repos
rosdep install -r --from-paths . --ignore-src --rosdistro rolling -y

Configure and build the workspace:

cd $COLCON_WS
colcon build --event-handlers desktop_notification- status- --cmake-args -DCMAKE_BUILD_TYPE=Release

Build HTML Pages Locally

If you want to test the tutorials by generating the HTML pages locally on your machine, you can use the build_locally.sh script in this repo.

If you are using Ubuntu 24.04 (or Python 3.11 or greater), you should first create a virtual environment.

python3 -m venv .venv
source .venv/bin/activate

Then, issue the following commands in the root of the moveit2_tutorials package:

cd $COLCON_WS/src/moveit2_tutorials

export ROS_DISTRO=rolling  # 24.04
source /opt/ros/$ROS_DISTRO/setup.bash

./build_locally.sh

The local website <LOCAL_PACKAGE_PATH>/build/html/index.html should automatically open in your web browser.

Optional build_locally Settings

  • noinstall skip the dependencies install step to speed up the script
  • loop automatically rebuilds the HTML if a change is detected

Formatting and Style

These tutorials use the reStructuredText format commonly used in the Sphinx “Python Documentation Generator”. This unfortunately differs from the common Markdown format, but its advantage is that it supports embedding code directly from source files for inline code tutorials.

Code Formatting

  • These tutorials use the same style guidelines as the MoveIt project. When modifying or adding to these tutorials, it is required that code is auto-formatted using clang format. To check and apply the style guidelines we use pre-commit.
  • Tutorials should exemplify best coding practices. If a contribution wouldn’t pass review in the MoveIt project, then it shouldn’t pass review in the tutorials.
  • Relevant code should be included and explained using the .. tutorial-formatter:: tag.
  • Irrelevant code should be excluded from the generated HTML using the BEGIN_TUTORIAL, END_TUTORIAL, BEGIN_SUB_TUTORIAL, and END_SUB_TUTORIAL tags.
  • Whenever possible, links should be created using the extlinks dictionary defined in conf.py.
  • All demo code should be runnable from within the moveit2_tutorials package.
  • Python code should be run using ros2 run.

Style

  • Each tutorial should be focused on teaching the user one feature or interface within MoveIt.
  • Tutorials should flow from show to tell with videos and demos at the beginning followed by explanations.
  • New tutorials should match the formatting, style, and flow of existing tutorials whenever possible.

pre-commit

pre-commit is a tool that is used in moveit2_tutorials to check and apply style guidelines automatically. To install pre-commit into your system:

pip3 install pre-commit

Then under the moveit2_tutorials directory install the git hooks like this:

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Recent questions tagged moveit2_tutorials at Robotics Stack Exchange

No version for distro galactic showing github. Known supported distros are highlighted in the buttons above.
Package symbol

moveit2_tutorials package from moveit2_tutorials repo

moveit2_tutorials

ROS Distro
github

API Docs
Browse Code

Package Summary

Tags No category tags.
Version 0.1.0
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description A sphinx-based centralized documentation repo for MoveIt 2
Checkout URI https://github.com/moveit/moveit2_tutorials.git
VCS Type git
VCS Version main
Last Updated 2025-06-29
Dev Status UNKNOWN
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

The moveit2_tutorials package

Additional Links

Maintainers

  • Dave Coleman
  • Mike Lautman

Authors

  • Sachin Chitta
  • Dave Coleman
  • Mike Lautman
README.md

MoveIt Tutorials

Live tutorials here

This is the primary documentation for the MoveIt project.

Build Status

This repository is built and deployed automatically by GitHub Actions:

  • Rolling (main): CI Format Deploy
  • Humble: CI Format Deploy

Contributing

We strongly encourage you to help improve MoveIt’s documentation. Please consider helping improve the tutorials, port old ones from ROS 1, and write new tutorials. We recommend you read the quality standards below as well as the How to Write a MoveIt Tutorial page.

If you find an issue with the tutorials you are not able to fix yourself, please open an issue on GitHub or open a PR with proposed changes.

Helping with Porting Tutorials to ROS 2

An issue has been created for each tutorial to be ported to ROS 2. At the top of each tutorial, there is a tag: “:moveit1:”, remove the tag after the tutorial has been successfully updated.

Below are some links to help with the ports.

MoveIt Tutorials Source Build

Follow the MoveIt Source Build instructions to set up a colcon workspace with MoveIt from the source.

Open a command line to your colcon workspace:

cd $COLCON_WS/src

Download the MoveIt Tutorials source code:

git clone https://github.com/moveit/moveit2_tutorials.git
vcs import < moveit2_tutorials/moveit2_tutorials.repos
rosdep install -r --from-paths . --ignore-src --rosdistro rolling -y

Configure and build the workspace:

cd $COLCON_WS
colcon build --event-handlers desktop_notification- status- --cmake-args -DCMAKE_BUILD_TYPE=Release

Build HTML Pages Locally

If you want to test the tutorials by generating the HTML pages locally on your machine, you can use the build_locally.sh script in this repo.

If you are using Ubuntu 24.04 (or Python 3.11 or greater), you should first create a virtual environment.

python3 -m venv .venv
source .venv/bin/activate

Then, issue the following commands in the root of the moveit2_tutorials package:

cd $COLCON_WS/src/moveit2_tutorials

export ROS_DISTRO=rolling  # 24.04
source /opt/ros/$ROS_DISTRO/setup.bash

./build_locally.sh

The local website <LOCAL_PACKAGE_PATH>/build/html/index.html should automatically open in your web browser.

Optional build_locally Settings

  • noinstall skip the dependencies install step to speed up the script
  • loop automatically rebuilds the HTML if a change is detected

Formatting and Style

These tutorials use the reStructuredText format commonly used in the Sphinx “Python Documentation Generator”. This unfortunately differs from the common Markdown format, but its advantage is that it supports embedding code directly from source files for inline code tutorials.

Code Formatting

  • These tutorials use the same style guidelines as the MoveIt project. When modifying or adding to these tutorials, it is required that code is auto-formatted using clang format. To check and apply the style guidelines we use pre-commit.
  • Tutorials should exemplify best coding practices. If a contribution wouldn’t pass review in the MoveIt project, then it shouldn’t pass review in the tutorials.
  • Relevant code should be included and explained using the .. tutorial-formatter:: tag.
  • Irrelevant code should be excluded from the generated HTML using the BEGIN_TUTORIAL, END_TUTORIAL, BEGIN_SUB_TUTORIAL, and END_SUB_TUTORIAL tags.
  • Whenever possible, links should be created using the extlinks dictionary defined in conf.py.
  • All demo code should be runnable from within the moveit2_tutorials package.
  • Python code should be run using ros2 run.

Style

  • Each tutorial should be focused on teaching the user one feature or interface within MoveIt.
  • Tutorials should flow from show to tell with videos and demos at the beginning followed by explanations.
  • New tutorials should match the formatting, style, and flow of existing tutorials whenever possible.

pre-commit

pre-commit is a tool that is used in moveit2_tutorials to check and apply style guidelines automatically. To install pre-commit into your system:

pip3 install pre-commit

Then under the moveit2_tutorials directory install the git hooks like this:

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Recent questions tagged moveit2_tutorials at Robotics Stack Exchange

No version for distro iron showing github. Known supported distros are highlighted in the buttons above.
Package symbol

moveit2_tutorials package from moveit2_tutorials repo

moveit2_tutorials

ROS Distro
github

API Docs
Browse Code

Package Summary

Tags No category tags.
Version 0.1.0
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description A sphinx-based centralized documentation repo for MoveIt 2
Checkout URI https://github.com/moveit/moveit2_tutorials.git
VCS Type git
VCS Version main
Last Updated 2025-06-29
Dev Status UNKNOWN
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

The moveit2_tutorials package

Additional Links

Maintainers

  • Dave Coleman
  • Mike Lautman

Authors

  • Sachin Chitta
  • Dave Coleman
  • Mike Lautman
README.md

MoveIt Tutorials

Live tutorials here

This is the primary documentation for the MoveIt project.

Build Status

This repository is built and deployed automatically by GitHub Actions:

  • Rolling (main): CI Format Deploy
  • Humble: CI Format Deploy

Contributing

We strongly encourage you to help improve MoveIt’s documentation. Please consider helping improve the tutorials, port old ones from ROS 1, and write new tutorials. We recommend you read the quality standards below as well as the How to Write a MoveIt Tutorial page.

If you find an issue with the tutorials you are not able to fix yourself, please open an issue on GitHub or open a PR with proposed changes.

Helping with Porting Tutorials to ROS 2

An issue has been created for each tutorial to be ported to ROS 2. At the top of each tutorial, there is a tag: “:moveit1:”, remove the tag after the tutorial has been successfully updated.

Below are some links to help with the ports.

MoveIt Tutorials Source Build

Follow the MoveIt Source Build instructions to set up a colcon workspace with MoveIt from the source.

Open a command line to your colcon workspace:

cd $COLCON_WS/src

Download the MoveIt Tutorials source code:

git clone https://github.com/moveit/moveit2_tutorials.git
vcs import < moveit2_tutorials/moveit2_tutorials.repos
rosdep install -r --from-paths . --ignore-src --rosdistro rolling -y

Configure and build the workspace:

cd $COLCON_WS
colcon build --event-handlers desktop_notification- status- --cmake-args -DCMAKE_BUILD_TYPE=Release

Build HTML Pages Locally

If you want to test the tutorials by generating the HTML pages locally on your machine, you can use the build_locally.sh script in this repo.

If you are using Ubuntu 24.04 (or Python 3.11 or greater), you should first create a virtual environment.

python3 -m venv .venv
source .venv/bin/activate

Then, issue the following commands in the root of the moveit2_tutorials package:

cd $COLCON_WS/src/moveit2_tutorials

export ROS_DISTRO=rolling  # 24.04
source /opt/ros/$ROS_DISTRO/setup.bash

./build_locally.sh

The local website <LOCAL_PACKAGE_PATH>/build/html/index.html should automatically open in your web browser.

Optional build_locally Settings

  • noinstall skip the dependencies install step to speed up the script
  • loop automatically rebuilds the HTML if a change is detected

Formatting and Style

These tutorials use the reStructuredText format commonly used in the Sphinx “Python Documentation Generator”. This unfortunately differs from the common Markdown format, but its advantage is that it supports embedding code directly from source files for inline code tutorials.

Code Formatting

  • These tutorials use the same style guidelines as the MoveIt project. When modifying or adding to these tutorials, it is required that code is auto-formatted using clang format. To check and apply the style guidelines we use pre-commit.
  • Tutorials should exemplify best coding practices. If a contribution wouldn’t pass review in the MoveIt project, then it shouldn’t pass review in the tutorials.
  • Relevant code should be included and explained using the .. tutorial-formatter:: tag.
  • Irrelevant code should be excluded from the generated HTML using the BEGIN_TUTORIAL, END_TUTORIAL, BEGIN_SUB_TUTORIAL, and END_SUB_TUTORIAL tags.
  • Whenever possible, links should be created using the extlinks dictionary defined in conf.py.
  • All demo code should be runnable from within the moveit2_tutorials package.
  • Python code should be run using ros2 run.

Style

  • Each tutorial should be focused on teaching the user one feature or interface within MoveIt.
  • Tutorials should flow from show to tell with videos and demos at the beginning followed by explanations.
  • New tutorials should match the formatting, style, and flow of existing tutorials whenever possible.

pre-commit

pre-commit is a tool that is used in moveit2_tutorials to check and apply style guidelines automatically. To install pre-commit into your system:

pip3 install pre-commit

Then under the moveit2_tutorials directory install the git hooks like this:

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Recent questions tagged moveit2_tutorials at Robotics Stack Exchange

No version for distro melodic showing github. Known supported distros are highlighted in the buttons above.
Package symbol

moveit2_tutorials package from moveit2_tutorials repo

moveit2_tutorials

ROS Distro
github

API Docs
Browse Code
Wiki

Package Summary

Tags No category tags.
Version 0.1.0
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description A sphinx-based centralized documentation repo for MoveIt 2
Checkout URI https://github.com/moveit/moveit2_tutorials.git
VCS Type git
VCS Version main
Last Updated 2025-06-29
Dev Status UNKNOWN
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

The moveit2_tutorials package

Additional Links

Maintainers

  • Dave Coleman
  • Mike Lautman

Authors

  • Sachin Chitta
  • Dave Coleman
  • Mike Lautman
README.md

MoveIt Tutorials

Live tutorials here

This is the primary documentation for the MoveIt project.

Build Status

This repository is built and deployed automatically by GitHub Actions:

  • Rolling (main): CI Format Deploy
  • Humble: CI Format Deploy

Contributing

We strongly encourage you to help improve MoveIt’s documentation. Please consider helping improve the tutorials, port old ones from ROS 1, and write new tutorials. We recommend you read the quality standards below as well as the How to Write a MoveIt Tutorial page.

If you find an issue with the tutorials you are not able to fix yourself, please open an issue on GitHub or open a PR with proposed changes.

Helping with Porting Tutorials to ROS 2

An issue has been created for each tutorial to be ported to ROS 2. At the top of each tutorial, there is a tag: “:moveit1:”, remove the tag after the tutorial has been successfully updated.

Below are some links to help with the ports.

MoveIt Tutorials Source Build

Follow the MoveIt Source Build instructions to set up a colcon workspace with MoveIt from the source.

Open a command line to your colcon workspace:

cd $COLCON_WS/src

Download the MoveIt Tutorials source code:

git clone https://github.com/moveit/moveit2_tutorials.git
vcs import < moveit2_tutorials/moveit2_tutorials.repos
rosdep install -r --from-paths . --ignore-src --rosdistro rolling -y

Configure and build the workspace:

cd $COLCON_WS
colcon build --event-handlers desktop_notification- status- --cmake-args -DCMAKE_BUILD_TYPE=Release

Build HTML Pages Locally

If you want to test the tutorials by generating the HTML pages locally on your machine, you can use the build_locally.sh script in this repo.

If you are using Ubuntu 24.04 (or Python 3.11 or greater), you should first create a virtual environment.

python3 -m venv .venv
source .venv/bin/activate

Then, issue the following commands in the root of the moveit2_tutorials package:

cd $COLCON_WS/src/moveit2_tutorials

export ROS_DISTRO=rolling  # 24.04
source /opt/ros/$ROS_DISTRO/setup.bash

./build_locally.sh

The local website <LOCAL_PACKAGE_PATH>/build/html/index.html should automatically open in your web browser.

Optional build_locally Settings

  • noinstall skip the dependencies install step to speed up the script
  • loop automatically rebuilds the HTML if a change is detected

Formatting and Style

These tutorials use the reStructuredText format commonly used in the Sphinx “Python Documentation Generator”. This unfortunately differs from the common Markdown format, but its advantage is that it supports embedding code directly from source files for inline code tutorials.

Code Formatting

  • These tutorials use the same style guidelines as the MoveIt project. When modifying or adding to these tutorials, it is required that code is auto-formatted using clang format. To check and apply the style guidelines we use pre-commit.
  • Tutorials should exemplify best coding practices. If a contribution wouldn’t pass review in the MoveIt project, then it shouldn’t pass review in the tutorials.
  • Relevant code should be included and explained using the .. tutorial-formatter:: tag.
  • Irrelevant code should be excluded from the generated HTML using the BEGIN_TUTORIAL, END_TUTORIAL, BEGIN_SUB_TUTORIAL, and END_SUB_TUTORIAL tags.
  • Whenever possible, links should be created using the extlinks dictionary defined in conf.py.
  • All demo code should be runnable from within the moveit2_tutorials package.
  • Python code should be run using ros2 run.

Style

  • Each tutorial should be focused on teaching the user one feature or interface within MoveIt.
  • Tutorials should flow from show to tell with videos and demos at the beginning followed by explanations.
  • New tutorials should match the formatting, style, and flow of existing tutorials whenever possible.

pre-commit

pre-commit is a tool that is used in moveit2_tutorials to check and apply style guidelines automatically. To install pre-commit into your system:

pip3 install pre-commit

Then under the moveit2_tutorials directory install the git hooks like this:

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Recent questions tagged moveit2_tutorials at Robotics Stack Exchange

No version for distro noetic showing github. Known supported distros are highlighted in the buttons above.
Package symbol

moveit2_tutorials package from moveit2_tutorials repo

moveit2_tutorials

ROS Distro
github

API Docs
Browse Code
Wiki

Package Summary

Tags No category tags.
Version 0.1.0
License BSD
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description A sphinx-based centralized documentation repo for MoveIt 2
Checkout URI https://github.com/moveit/moveit2_tutorials.git
VCS Type git
VCS Version main
Last Updated 2025-06-29
Dev Status UNKNOWN
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

The moveit2_tutorials package

Additional Links

Maintainers

  • Dave Coleman
  • Mike Lautman

Authors

  • Sachin Chitta
  • Dave Coleman
  • Mike Lautman
README.md

MoveIt Tutorials

Live tutorials here

This is the primary documentation for the MoveIt project.

Build Status

This repository is built and deployed automatically by GitHub Actions:

  • Rolling (main): CI Format Deploy
  • Humble: CI Format Deploy

Contributing

We strongly encourage you to help improve MoveIt’s documentation. Please consider helping improve the tutorials, port old ones from ROS 1, and write new tutorials. We recommend you read the quality standards below as well as the How to Write a MoveIt Tutorial page.

If you find an issue with the tutorials you are not able to fix yourself, please open an issue on GitHub or open a PR with proposed changes.

Helping with Porting Tutorials to ROS 2

An issue has been created for each tutorial to be ported to ROS 2. At the top of each tutorial, there is a tag: “:moveit1:”, remove the tag after the tutorial has been successfully updated.

Below are some links to help with the ports.

MoveIt Tutorials Source Build

Follow the MoveIt Source Build instructions to set up a colcon workspace with MoveIt from the source.

Open a command line to your colcon workspace:

cd $COLCON_WS/src

Download the MoveIt Tutorials source code:

git clone https://github.com/moveit/moveit2_tutorials.git
vcs import < moveit2_tutorials/moveit2_tutorials.repos
rosdep install -r --from-paths . --ignore-src --rosdistro rolling -y

Configure and build the workspace:

cd $COLCON_WS
colcon build --event-handlers desktop_notification- status- --cmake-args -DCMAKE_BUILD_TYPE=Release

Build HTML Pages Locally

If you want to test the tutorials by generating the HTML pages locally on your machine, you can use the build_locally.sh script in this repo.

If you are using Ubuntu 24.04 (or Python 3.11 or greater), you should first create a virtual environment.

python3 -m venv .venv
source .venv/bin/activate

Then, issue the following commands in the root of the moveit2_tutorials package:

cd $COLCON_WS/src/moveit2_tutorials

export ROS_DISTRO=rolling  # 24.04
source /opt/ros/$ROS_DISTRO/setup.bash

./build_locally.sh

The local website <LOCAL_PACKAGE_PATH>/build/html/index.html should automatically open in your web browser.

Optional build_locally Settings

  • noinstall skip the dependencies install step to speed up the script
  • loop automatically rebuilds the HTML if a change is detected

Formatting and Style

These tutorials use the reStructuredText format commonly used in the Sphinx “Python Documentation Generator”. This unfortunately differs from the common Markdown format, but its advantage is that it supports embedding code directly from source files for inline code tutorials.

Code Formatting

  • These tutorials use the same style guidelines as the MoveIt project. When modifying or adding to these tutorials, it is required that code is auto-formatted using clang format. To check and apply the style guidelines we use pre-commit.
  • Tutorials should exemplify best coding practices. If a contribution wouldn’t pass review in the MoveIt project, then it shouldn’t pass review in the tutorials.
  • Relevant code should be included and explained using the .. tutorial-formatter:: tag.
  • Irrelevant code should be excluded from the generated HTML using the BEGIN_TUTORIAL, END_TUTORIAL, BEGIN_SUB_TUTORIAL, and END_SUB_TUTORIAL tags.
  • Whenever possible, links should be created using the extlinks dictionary defined in conf.py.
  • All demo code should be runnable from within the moveit2_tutorials package.
  • Python code should be run using ros2 run.

Style

  • Each tutorial should be focused on teaching the user one feature or interface within MoveIt.
  • Tutorials should flow from show to tell with videos and demos at the beginning followed by explanations.
  • New tutorials should match the formatting, style, and flow of existing tutorials whenever possible.

pre-commit

pre-commit is a tool that is used in moveit2_tutorials to check and apply style guidelines automatically. To install pre-commit into your system:

pip3 install pre-commit

Then under the moveit2_tutorials directory install the git hooks like this:

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Recent questions tagged moveit2_tutorials at Robotics Stack Exchange