This page is intended to be an entry point for anyone trying to run IHMC Robotics software. There is a vast variety of ways to get to running our software, so this page will never be perfect.

If you are an IHMC employee, intern, or volunteer, please see also the onboarding guide.

Our content is always looking for improvement. If there is something we missed, could be better clarified, or incorrect/out-of-date information, please feel free to modify these pages or ask someone on the team to help.

Getting Help

Knowing how to get help is the most important part of getting setup.

To get help, please sign into our Slack workspace and use the #help-desk channel.

Please post screenshots, stacktraces, logs and error messages if at all possible.

Following these guidelines are important to:

Asking for help on Slack is especially better than asking someone to come to your desk and look at your issue. Of course, that is fine occasionally.

Guide Directory

Below are some guides to using IHMC robotics software. Pick one or use a little bit of each to get up to speed according to your needs.

General Development Environment Setup Guide - Most flexibility, least hand-holding. Pick your tools with tips and tricks. Duncan supports this guide.

Jerry's Preferred Software Setup Guide -  Maximal hand holding, but requires that you use Windows10 and Eclipse. Jerry will answer your setup questions if you follow this guide.

Simulation Construction Set and Controller Tutorials - Sylvain supports this guide. It uses Eclipse as the IDE.

Out of date

Don't use these guides!

Beginner Quick Start: Hex Runner Simulation (DO NOT USE)* - On rails, Eclipse IDE. Simplest, fastest way to get SCS running a robot simulation. (* out of date)

Dynamic Walking 2018 Workshop Tutorial - Not maintained.

Simulation Construction Set Tutorials on Confluence - Not maintained. This was the original SCS tutorial.

Simulation Construction Set Tutorials on Github IO - Not maintained, out of date, but probably the prettiest SCS tutorial.

IHMC Robotics Github IO - Not maintained and completely out of date.