Page tree
Skip to end of metadata
Go to start of metadata

This page is an attempt at a new style of help for users. Since there is an essentially infinite set of tool combinations to use, we will supply a guide for each tool, written by an IHMC developer who uses that tool. A lot of these pages are not yet complete.

Getting Started

In general:

  1. Pick an operating system
    Ubuntu Desktop -
    Windows - but you must apply this solution: Long Paths in Windows
    MacOS -
  2. Install all of the following:
    JDK 8u131 or higher (we do not yet support 9) -
    Git -
    Gradle -
  3. Pick a graphical Git tool (optional)
    SmartGit - SmartGit (install guide, license files)
  4. Choose and install an IDE:
    1. IntelliJ -
      1. Streamlined user experience
      2. Superior Gradle script editing
      3. Problems on Windows w/ long classpaths
    2. Eclipse -
      1. Faster compilation, quicker to launch simulations
      2. Fantastic multi-monitor support
      3. Really bad Gradle editor
  5. Use Git to create a repository-group w/ IHMC Open Robotics Software
    - In your system home folder (or C:/ drive in Windows), clone a copy of repository-group
    - Inside the repository-group folder, clone ihmc-open-robotics-software
    It should look like:
    ├── ihmc-open-robotics-software
    │   └── build.gradle
    │   └──
    │   └── settings.gradle
    ├── build.gradle
    └── settings.gradle

    There are several choices for cloning a repository, including command line, graphical git tool, or your IDE. For example, in Eclipse, add the Git perspective and various Git tools will be available through the GUI, including clone. To get the URL for the repository you wish to clone, when you open it in stash, click on the clone button in the upper left of the window: 

    You may wish to clone more projects depending what you are working on. Atlas and Valkyrie simulations are included in Open Robotics Software but not their user interfaces.  Take a look at what repositories are available here: Default Repository Clone List

  6. Use the IDE to import the code you cloned
    1. IntelliJ
      1. Perform the Import directly on the repository-group folder or the repository-group/build.gradle file.
      2. More info at
    2. Eclipse 
      1. File->Import->Gradle→Existing Gradle Project. Use the Gradle version that you installed in the Gradle install step above.
      2. Perform the Import directly on the repository-group folder or the repository-group/build.gradle file.
      3. More info at
  7. Learn about Java/Gradle, read project READMEs
    ihmc build plugin -
    repository group -
  8. There are a few things that need to be setup for your IDE to avoid a few known problems. Do the steps below under "Integrated Development Environments".
  9. To see if everything is working, run some sample simulations. For example or
  10. Setup your IDE and other tools for high productivity.

Operating Systems

Getting Started with Ubuntu Desktop - Free, most compatible with robots

Getting Started with Windows

Getting Started with Mac OS X

Git Tools

Getting Started with Git (command line)

Getting Started with vcstool - Batch Git operations on groups of repos on command line

SmartGit (install guide, license files) - Requires license, most feature complete Git GUI

Getting Started with IntelliJ VCS Plugin - Very nice to use, can be sluggish

Getting Started with Eclipse EGit VCS Plugin - Not many features, buggy

Integrated Development Environments (IDEs)

Getting Started with IntelliJ IDEA

Getting Started with Eclipse IDE

Build Tools

Getting Started with Java

Getting Started with Gradle