Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
December 22, 2017 15:03
November 30, 2020 15:39
August 27, 2019 11:45
June 18, 2020 08:37
November 23, 2017 11:11

Niryo One ROS stack

Licensed under GPLv3 (see LICENSE file)

(Niryo One :

niryo one rviz simulation

This repository contains all ROS packages used on Niryo One (Raspberry Pi 3B - Xubuntu for ARM).

How to use Niryo One with a graphical interface ?

You can download Niryo One Studio (Linux, Windows and MacOS compatible).

How to install Niryo One ROS packages on your computer (x86) - Simulation Mode

Requirements :

  • Ubuntu 16.04
  • ROS kinetic (other versions are not supported)

First install ROS kinetic "Desktop-Full" (tutorial here).

You'll need to install some additional ROS packages :

sudo apt-get install ros-kinetic-robot-state-publisher ros-kinetic-moveit ros-kinetic-rosbridge-suite ros-kinetic-joy ros-kinetic-ros-control ros-kinetic-ros-controllers ros-kinetic-tf2-web-republisher

You'll also need to install an additional Python module :

sudo -H pip install jsonpickle

Create a catkin workspace and clone Niryo One ROS stack :

mkdir -p ~/catkin_ws/src
cd ~/catkin_ws/src
git clone .

Build the packages :

cd ~/catkin_ws

Don't forget to use those commands before you try to launch anything (you can add them in your .bashrc) :

source /opt/ros/kinetic/setup.bash
source ~/catkin_ws/devel/setup.bash

You can now launch Rviz with Niryo One (only display mode with some cursors to move the joints):

roslaunch niryo_one_description display.launch

You can also launch the complete Niryo One ROS Stack instead, which you can control from Niryo One Studio.

roslaunch niryo_one_bringup desktop_rviz_simulation.launch

The main differences between this launch file and the launch file executed on Raspberry Pi 3B (rpi_setup.launch) is that the hardware functionalities are disabled, and you get a 3D simulation view with Rviz.

Note that Niryo One ROS packages have been developed with ROS kinetic, on Ubuntu 16.04. Other ROS versions and OS distributions are not supported.

(Optional) After you install ROS packages and execute catkin_make you still have some installation steps if you want to use Blockly ("Niryo Blocks" on Niryo One Studio).

Make sure that you have a recent nodejs version (not the default installed one)

curl -sL | sudo -E bash -
sudo apt-get install -y nodejs

Install node modules in the blockly_code_generator directory (where you can find package.json) and create an executable.

cd ~/catkin_ws/src/niryo_one_user_interface/blockly_code_generator
npm install
sudo npm link

That's it, you have now all the Niryo One functionalities ready to be used.

Niryo One ROS Stack overview

Here's a global overview of the Niryo One ROS Stack :

niryo one ros stack - global overview

You can find more specific and detailed info in each package's README.

Developer Documentation

Any question ?

If you have a question and you don't find the answer here or on our documentation, please send us a message.

Thank you !