Detailed Mac Installation Instructions

Home page for installation instructions is: Install Roadrunner.

Mac OS X

  1. Typical Installation – using Finder  – (non-command line)
    1. Download libroadrunner-[version]-mac64.tar.gz
    2. Open the first Finder window and select the Downloads directory
    3. Expand the tar.gz file. You can do this by double-clicking on it in the folder.
    4. Open a second Finder window.
      Menu File > New Finder Window (⌘N)
    5. Finder menu Go > Go to Folder (⇧⌘G) and paste this folder location:  /Library/Python/2.7/site-packages/
    6. In the first Finder window got into the directories just expanded, libroadrunner-[version]-mac64/site-packages/ select and copy (⌘C) roadrunner/.
    7. In the second Finder window Paste (⌘V)  so that roadrunner is placed in /Library/Python/2.7/site-packages/.
  2. (Alternate) Installation using Terminal  – (command line)
    1. Use Applications > Terminal  to paste the following commands.
    2. Make directory to install roadrunner to. Note: these instructions  place the installation dir libroadrunner-[version]/ in your user HOME directory, adjust as desired.
      mkdir -p ~/libroadrunner-1.0
    3. Download using curl. Note: the -L is needed to get from sourceforge.
      curl -o ~/libroadrunner-1.0/libroadrunner-1.0-mac64.tar.gz -L
    4. Untar  (cd into the  dir  where we downloaded the libroadrunner-1.0.1-mac64.tar.gz file)
      cd ~/libroadrunner-1.0
      tar -xvzf libroadrunner-1.0-mac64.tar.gz -C ~/libroadrunner-1.0
    5. Copy the roadrunner directory in libroadrunner-1.0/site-packages/ to /Library/Python/2.7/site-packages, the system site-packages.
      sudo cp -r ~/libroadrunner-1.0/site-packages/roadrunner/ /Library/Python/2.7/site-packages/roadrunner
  3. (Alternatively) Copy into the user site-packages which is usually /Users/USERNAME/Library/Python/2.7/lib/python/site-packages
  4. Run python, import roadrunner
    >>> import roadrunner
    1. If you do not already have numpy for python 2.7 install it, or get other versions here.
    2. If you need to upgrade Python install Python 2.7 for OSX. (Step 6 below describes how to install numpy using pip)
    3. If you do not already have matplotlib for python2.7 install it, or get other versions here.
  5. To test that you have it running, type the following to get the version number
    >>> roadrunner.__version__
    '1.0.1; Compiler: clang "3.3 (tags/RELEASE_33/final)"; Date: Dec 18 2013, 22:17:00'
  6. (Optional) Update numpy, install ipython
    1. Using pip in Terminal
      sudo easy_install pip
    2. (Optional) un-install and re-install numpy
      sudo pip uninstall numpy
      sudo pip install numpy
    3. (Recommended) install iPython, run the following command
      sudo pip install ipython
    4. run iPython in the Terminal by typing
      import roadrunner
  7. Go to and Read the Python API documentation to learn how to use libRoadRunner in Python.