Install Livestock


Livestock is a plugin to Grasshopper for Rhino. It is therefore an requirement that those two programs are installed for it to work. If they are install it should be pretty straight forward to install the rest.

Grasshopper Dependencies

Livestock depends on ghPython, which is what makes it possible to create Python components in Grasshopper. ghPython can be downloaded here

To Install: In Grasshopper, choose File > Special Folders > Components folder. Save the gha file there. Right-click the file > Properties > make sure there is no "blocked" text * Restart Rhino and Grasshopper

Livestock also explicitly depends on Ladybug Tools. They can be downloaded from here.

Download Livestock Grasshopper

Now you are ready to get Livestock installed! All you need to do is to download this zip

Download the latest Livestock Release

  • Create a folder at %appdata%\McNeel\Rhinoceros\5.0\scripts called livestock
  • Put all the files from the folder "Python Rhino Script" in there.
  • Create a folder at %appdata%\Grasshopper\UserObjects called livestock
  • Put the files from the folder "Grasshopper User Objects" in there.
  • Move the folder "Examples" to a location of your choosing.
  • On the C-drive create a folder called livestock as well.

Anaconda Install

Now when all th files for Grasshopper is in place it is time to complete the installation by installing CPython. Livestock depend on Anaconda environments to run CPython. So it needs to be installed. If you already have Anaconda installed, you can just skip this part and go straight to setting up the Conda environment.

Use this link to download and install Miniconda. Miniconda is the lightweight version of Anaconda. If you already installed Anaconda it is also fine. It will make no difference to the functionality of Livestock.

Remember to check the box with: "Add Anaconda to my PATH environment variable, even if it prompts you with a warning. Second check box is optional"

Conda Environment

When Anaconda is installed you are ready to create a conda environment specific to run Livestock. Open the command or Anaconda promt. (with adimin rights and you may need to turn off sll verification)

Type in:

conda create -n livestock_env python=3.6

Conda then will the install the environment called "livestock_env". Afterwards the environment can be activated:

activate livestock_env

Your CPython 3.6 environment is now ready, however to make CPython talk to Grasshopper via the Livestock protocols we need to install the packages: numpy, scipy, paramiko and shapely you may also install other packages such as matplotlib or many other conda packages Conda packages in this way:

conda install numpy scipy shapely paramiko matplotlib

Your CPython 3.6 environment is almost ready, to take full advantage of the Livestock ecosystem we just need to use pip to install the Livestock CPython dependencies:

pip install livestock

Just ignore any Cython related warnings.