Working in Rhino

Installing COMPAS for Rhino is very simple. Just type the following on the command line

$ python -m compas_rhino.install

Optionally, you could provide a Rhino version number (5.0, 6.0). The default is 6.0.

$ python -m compas_rhino.install -v 6.0


On Windows, use the “Anaconda Prompt” instead of the “Command Prompt”, and make sure to run it as administrator.

On Mac, use the Terminal.

If you installed COMPAS using conda, which is highly recommended, make sure that the environment in which you installed COMPAS is active when you issue the above commands.


If you are using Rhino 5.0, you may also want to replace the version of IronPython that comes with it, such that everything works properly.

To check your IronPython version in Rhino, go to the PythonScript Editor

Tools > PythonScript > Edit

There, run the following snippet.

import sys
print sys.version_info

This will display something like

sys.version_info(major=2, minor=7, micro=5, releaselevel='final', serial=0)

If the releaselevel is not 'final', install IronPython 2.7.5 and let Rhino know where it is by adding it to the Rhino Python Editor search paths.


Install IronPython 2.7.5, and not the latest version of IronPython. Rhino doesn’t like it…

In the Rhino Python Editor, go to

Tools > Options

And add



Restart Rhino and check the version info as before.

Install COMPAS packages

The procedure for installing a COMPAS package in Rhino is similar to installing COMPAS itself.

Working with virtual environments

Installing plugins

XFunc and RPC