algorithmic modeling for Rhino



Kangaroo is a Live Physics engine for interactive simulation, optimization and form-finding directly within Grasshopper.

Read about the new release here

The Discussion Forum below is the best place to ask any questions about using Kangaroo.

(Please avoid posting questions on the Comment Wall, as it does not allow organization of replies)

Members: 2712
Latest Activity: 3 hours ago

You can read an introduction to the ideas behind Kangaroo here:

Kangaroo2 is now available for testing (see full announcement here). Please bear in mind this is still a work-in-progress, and features are still subject to change.

You can download it from here:

This thread contains some troubleshooting tips if you have problems getting it installed and working:

The main source of example files for the latest version is here:

Some further example files for version 2.0 can be found here:

with more to follow - if there is some particular feature you would like more examples of information on please ask there.

The Kangaroo2 solver library is now separate from the Grasshopper components, and can also be referenced and used in scripts, either in the GH VB/C#/Python components, or in RhinoScript/PythonScript in Rhino. Questions about these can also be posted on:

Kangaroo2 is a complete rewrite, and the main solver/goal/force components are not cross-compatible with the previous version. However, you can keep both versions installed together allowing older definitions to be opened, and for now this is recommended, as there are also several utility and mesh processing functions relevant to both versions.

While v2 introduces many new features and improvements, not all the features from the old version currently have equivalents in the new version, but the plan is to add them all over time.

The links below are for the old version. More documentation and videos for the new version to appear soon.

example files(for version 0.099):

manual(for version 0.099):

getting started video:

demo videos:

Some more tutorial videos from EXLAB:

Discussion Forum

Problems installing kangaroo 3 Replies

Hi, I am trying to install Kangaroo in a machine running Grasshopper 0.9.0076 and Rhino 5 SR 12.When loading Grasshopper I get the following errors:Object: MeshMachineComponent3 (level 1){Exception has been thrown by the target of an…Continue

Started by mire. Last reply by Carolina Wundes 3 hours ago.

The interconnectPoints component that did not work in version 2.42 1 Reply

Hi there.I found a problem,The interconnectPoints component that did not work in version 2.42; I repeatedly checked in the older version of 0.99 is normal. Is this a BUG?Continue

Tags: work, in, version, 2.42, not

Started by ANNA. Last reply by ANNA yesterday.

Circle packing definition 29 Replies

Here's an example definition showing how to generate a circle packing from an arbitrary triangulation:…Continue

Started by Daniel Piker. Last reply by Daniel Piker on Tuesday.

Scripting Kangaroo 2: check for convergence? 2 Replies

Hello all!I'm learning to do some C# scripting with Kangaroo. I was wondering if there was a built-in or easy way to test for convergence of a simulation within the Library, or do I have to make my own checks on particular geometry?I'm trying to…Continue

Started by Oliver Bucklin. Last reply by Oliver Bucklin Mar 6.

Gyroid structure 12 Replies

Hey guysI'm trying to find a simple way to make gyroid structure by kangaroo, anybody know what's the best way?! I'll be happy if you share your related experiences with me, thanks! …Continue

Tags: Structure, Kangaroo, Gyroid

Started by Ali Bazazan. Last reply by Xin Mar 6.

Origami in Kangaroo2 3 Replies

Hi Daniel,I am using kangaroo2 to model origami.When I try to open your example files, it says that some objects are not available (springs from line, fold angle, hinge points). Could help me on this? Best Regards,AnaContinue

Started by Ana Clara Vianna. Last reply by Daniel Piker Mar 6.

News and Updates

Force polygons of equilibrium structures

I have recently been exploring some reciprocal force diagrams using Kangaroo. From the 1869 paper by James Clerk Maxwell On reciprocal figures, frames and diagrams of forces : …to construct the Polygon of Forces, by drawing in succession lines parallel and proportional to the different forces, each line beginning at the extremity of the last. If the forces acting at the […]

Minimal surface puzzle

The top row shows three different minimal surfaces from the same boundary curves. The bottom row shows the same 3 surfaces rotated and in a different order. Which number corresponds to which letter?

Orthogonal Clustering

I’ve always aimed to make Kangaroo a specifically architectural physics engine. While it shares many characteristics with similar engines used for other purposes, such as games and animation, it has some features that are uniquely suited to designing buildings. Form-finding and physics-based-modelling often result in curved shapes, with an elegant and natural appearance which is something […]

Variation from Uniformity

All of these triangles are identical and equilateral: In architectural geometry over the last few decades, a common topic of research has been how to build and clad doubly curved surfaces in an efficient way. While computer aided manufacturing has made it possible to make buildings where every panel has slightly different dimensions, there are […]


      As regular readers of this blog will know, I’m passionate about the use of relaxation and force-based methods for optimizing geometry in a very interactive way. There is a great variety of form-finding that can be done by assigning physical forces as interactions between sets of particles. However, in my investigations so […]

Comment Wall


You need to be a member of Kangaroo to add comments!

Comment by Daming on February 25, 2018 at 7:51am

I have found that the interconnectPoints Component(Utility) may has some error, the interconnetctions may be not out put.

Comment by Mostafa Abd-El-Raouf Ahmed on November 29, 2017 at 12:22am
Guys i am new to kangaroo and kindda amateur too in grasshopper .. so i have a question .. how can i achieve a smooth mass to conform on two closed curves

My curves here :
And a simple loft is here to just see what I intend to do
Comment by Michael Pryor on November 28, 2017 at 7:06pm

@Valmir Kastrati  it is called "Length(Line)" in K2

Comment by Valmir Kastrati on November 28, 2017 at 4:52pm

Can anyone tell me which component in Kangaroo2 is "Springs" from Kangaroo 1?

Comment by weizhiwei on November 23, 2017 at 9:37am

Hi all, I'm a really new grasshopper user, These days I have learned how to use Kangaroo2 to solve a problem.

But I have some trouble with the component "PolygonArea".

Comment by Philippe Hannequart on November 17, 2017 at 3:10am

Hi all, How can I model a shell in Kangaroo2 ? The triangular shell element from Kangaroo1 disappeared?

Comment by Jupiterator on October 29, 2017 at 5:27pm

Hi Daniel,

Is the version of Kangaroo for OSX different than Windows?

I'm looking for the SpringsFromMesh component I've seen in a tutorial, but I can't find it anywhere.

Any help would be greatly appreciated!

Comment by Martin Siegrist on September 1, 2017 at 6:53am
Hi Daniel, I spent the last ten hours trying to remember how to use the SolidPointCollide component. I need to hang a relaxed mesh inside another mesh. Too much to explain. Well, I figured it out at some point.... now it works pretty well.

Just wanted to say thank you for programming such an awesome set of tools!
Comment by Earth on July 22, 2017 at 4:32pm

Hi all, where does Kangaroo define literally the mass of springs? The thing is, when using Kangaroo, there is no mass input, and  if I applied force=0 then displaced the support, why the structure vibrates when there is no mass defined anywhere?

The second thing is that, when I applied very high value of stiffness, with proper support conditions, the elements fly off to there screen (displacement=infinity=null), even if there is no force applied, anyone know why?

help :)

Comment by Grazia Pota on May 7, 2017 at 4:29am

Hi everyone, I've a simple question. Is there an equival component for PowerLaw in Kangaroo 2?






  • Add Photos
  • View All

© 2018   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service