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: 2292
Latest Activity: 16 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:

The 2.0 download includes a first draft of the manual and a collection of example files.

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

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

Vortex Force in K2 2 Replies

Does anyone have ideas about how to develop a vortex force in kangaroo2? Continue

Started by Moonbeast. Last reply by Moonbeast 16 hours ago.

Inflated Tension Structures in Kangaroo 2 1 Reply

Hello Everyone,I am part of a small design collective experimenting with inflatable structures called pneuhaus. I have been dabbling with Kangaroo 1 for quite some time and am trying to make the jump…Continue

Tags: Tension, Pressure, Kangaroo 2

Started by August Lehrecke. Last reply by Daniel Piker 17 hours ago.

Newbie question re: hinge + collision 1 Reply

Hi all,I'm an advanced Rhino & GH user, but total beginner with Kangaroo.  I'm trying to setup a basic hinge that stops when the two halves crash into each other (think of a hinged bracelet).  I can make the hinge open/close (although it's…Continue

Started by Declan Halpin. Last reply by Daniel Piker 18 hours ago.

Creating a dream catcher 13 Replies

Hello all, I am a beginner at Grasshopper and Kangaroo...Can anyone point me to the right direction how to re-create a dream catcher where each line is bend/pulled by the next one. So all lines end up bend and being pulled towards the middle. I…Continue

Started by Aleksandra Wojciak. Last reply by Aleksandra Wojciak yesterday.

simulating a net behaviour with constraining edges 3 Replies

Hi geniuses, I'm stuck on a problem for quite a while now. I want to make a realistic net under gravity. I've searched quite a few defs online but I don't seem to find any related to my need.... I've come across the minimal surface / relaxation def…Continue

Started by shuo zhang. Last reply by shuo zhang on Saturday.

Kangaroo simulation on a curved surface with irregular mesh 10 Replies

Hi guys,I would like to make two models (one with positive Gaussian curvature and one with negative Gaussian curvature). First 2 curves are made were both ends are closed by a line.The surface created from these curves/lines needs to be meshed…Continue

Started by Sebastien de Wit. Last reply by Sebastien de Wit on Friday.

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 Luis García Lara on December 14, 2013 at 3:27pm

Hi Daniel,

this is my first try with origami folding, i use the example file with the new component mesh foldings but i miss something...
i need to put some anchor points?
Thanks in advance

Comment by Dēmiurgos on December 9, 2013 at 11:10pm

Hello everyone.

I was looking for the extra Kangaroo components. Does any have some links for downloading?


Comment by Shridhar Mamidalaa on November 23, 2013 at 9:29pm

Hi, all

Kangaroo has been able to do a lot simulations, is it also possible to do "CFD" like flow with points or meshes which will be fine if its happening through a curve guidance... but is it possible..??  

Any ideas.??

Thank u..

Comment by Andrei Raducanu on November 17, 2013 at 5:11am

Hi, everyone!

Do You know why sometimes the geometry out results in 0 length curves?

Everything seems to be working fine for the particles, they do act as if they have springs between them, but the lines between them disappear at the first iteration (btw, i used the lines that form the springs as geometry input)

This is not the first time i encounter this and i guess it's kind of a newbie dilemma, so maybe someone can help... Thanks!

Comment by Danny Boyes on November 8, 2013 at 7:50am

Hi Matti,

Find the Kangaroo.dll file (easiest way is to use File > Special Folders > Components)

and right click on it, select Properties and the UNBLOCK

Comment by Matti Pirinen on November 8, 2013 at 7:45am

Getting this error message after installing kangaroo, while i'm starting grasshopper

Any suggestions?

Comment by William E Bodell III on October 18, 2013 at 2:41pm

Hello all,

I am trying to use Kangaroo to do a bit of sphere packing, using different sizes of spheres related to the required program areas. I have seen some examples of 2d circle packing, and I've tried to translate this into 3d spheres, but I can't figure out how to set the desired sizes and prevent overlapping. Any advice?




Comment by Fereshteh Shahmiri on October 14, 2013 at 1:17am

I was wondering if you could help me about an issue.

I have a surface and I am trying to achieve water flow trail upon it. I don't why but the particles don't have any reaction in response to the surface.

Thank you.



Comment by bruno di vito on September 12, 2013 at 4:21pm


I was trying to make this simple boat flotating but I don' t figure out how, I did it with a sphere just adding some springs inside the shape to avoid the geometry collapse..(I didn't find similar examples posted)

Thanks in advance


Comment by Miguel Villegas on August 29, 2013 at 12:32am

Hi. I'm having the exact same problem Jimmz stated just below. Files are placed and unlocked. Any guesses on the solution? Thanks in advance.



Search Grasshopper


  • Add Photos
  • View All

© 2016   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service