Awesome Open Source
Awesome Open Source

Ubuntu Setup Scripts for Robotics & Machine Learning

Robotics Automated Setup

This contains a set of linux setup scripts consolidated from across the web to make it easy to set up a new computer for robotics and deep learning, with links to the original sources and brief descriptions in the comments of each script. Install scripts are kept simple and minimal so you can easily change them for your needs.

Manual steps are necessary for some scripts, so be sure to check the comments!

These scripts are written for:

  • x86_64 Ubuntu Linux 14.04, 16.04, 18.04
  • NVIDIA GPUs such as GeForce GTX 1080, and Titan X.

There is also some support for:

There are also useful config files in this repository named .* that may not be immediately visible, such as .byobu/.tmux.conf.

Getting started

Typically the source code for libraries will be put in ~/src/, and binaries in /usr/local, but this rule is not hard and fast because some tools like nvidia's cuda must go elsewhere.

mkdir -p ~/src
cd ~/src
git clone [email protected]:ahundt/robotics_setup.git
cd ~/src/robotics_setup
# be sure to look at the script for special instructions!
vim <scriptname>.sh
# if the above line doesn't work you can also do sh <scriptname>.sh

Open the shell scripts

Be sure to open the install scripts before you run them. There are often manual steps, more details, and links to the reference documentation and blogs used to write these scripts.

Command line, terminal, zsh

Recommended command line utils include htop, vim, tmux, byobu. To install them run:


The recommended terminal environment and shell is zsh with prezto utilities, to install and configure it to run with tmux and byobu so you can have multiple terminal windows and connect via ssh without losing your place or closing your running terminal applications:


This will automatically set up .robotics_setup, a configuration automatically loads other tools you can install via this repository including ROS, cuda, google go, locally installed binaries, linuxbrew, etc.

Xonsh shell is a terminal shell like bash and zsh that is like a superset of python and bash. It is very useful for robotics and machine learning if you want to do some math on robot data in your shell and run applications in a single terminal, plus retain the history of your commands so you can reproduce your work. You can install xonsh with the instructions and then enable it as the default shell.

byobu, lets you have multiple terminals running over a single connection that are persistent across dropped connections. If you want to use it with xonsh, make sure to update your ~/.byobu/.tmux.conf to specify xonsh instead of zsh:

# set -g default-shell /usr/bin/zsh
# set -g default-command /usr/bin/zsh
set -g default-shell ~/.local/bin/xonsh
set -g default-command ~/.local/bin/xonsh

Additional helpful tips

We highly recommend putting this repository in ~/src, but that's not required. To make your shell utilize the tools you've installed via robotics_setup:

# Add this to your ~/.bashrc or your ~/.zshrc
# From
source ~/src/robotics_setup/.robotics_setup

For a pile of info snippets to troubleshoot a variety of problems you might encounter see:

For robotics resources see:

For great instructions for some of the best tools to use for development (much applies to non-mac too) see:

For other information on a huge range of topics see:


All scripts are set to exit immediately on any error so it will give you a chance to fix the problem without making a mess on your computer.


Script exited without installing the software

If you run a script and the software was not installed, the most likely culprit is the repositories you have configured on ubuntu. If any repository returns an error these scripts will exit, to fix it look at which repositories are in the command line error message, and follow these instructions to remove them:


For something with more advanced capabilities than this repository, though not always easier, I suggest and

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (1,140,932
Shell (228,885
Deep Learning (23,665
Linux (16,975
Tensorflow (12,783
Bash (7,129
Keras (5,758
Robotics (3,483
Ubuntu (3,398
Zsh (3,353
Ros (2,859
Bash Script (1,870
Robot (1,662
Setup (548
Install (363
Ubuntu1604 (184
Eigen (145
Vrep (70
Ubuntu1404 (39
Ceres Solver (20
Grl (4
Related Projects