algorithmic modeling for Rhino

Quelea - agent-based design for Grasshopper


Quelea - agent-based design for Grasshopper

Agent-Based Design for Grasshopper
+ A new paradigm for 3D modeling utilizing agents.
+ Assign forces and behaviors to systems of agents to create interactions.
+ Utilize any data to drive the system.
+ Easily debug your system by displaying individual force vectors.
+ High performance, parallel algorithms, spatial data-structures.
+ Write your own custom forces, no coding required.
+ Open source framework for others to build custom behaviors.
+ Boid forces: Cohese, Separate, Align, & View.
+ Contain Agents within Brep, Box, Surface, and Polysurface environments.
+ Forces: Path Follow, Attract, Contain, Surface Flow, Seek, Arrive, Avoid Obstacle, Avoid Unaligned Collision, Sense Image, Sense Point, & more to come.
+ Behaviors: Bounce Contain, Kill Contain, Initial Velocity, Eat, Set Velocity, & more to come.

Future work:

+ Behaviors to drive simulations of people and vehicles.

+ Temporal inputs can change the actions of the system over time.

Download the add-on on Food4Rhino

If you find any bugs or have any feature requests please post them on the GitHub Issue Tracker which will allow everyone to see which bugs are open or closed and allows me to update you when it is fixed.

This is an open source project so if you need custom defined forces or behaviors for your project reach out to me about becoming a committer.

View the project on GitHub

To get started check out this video tutorial on how to set up a basic particle scene. Follow along with this example script.

Learn how to set up a flocking simulation with agents in this video tutorial and example file.

To learn more about the polymorphic type system in the latest release of Quelea see this video explanation.

For questions on how to use Quelea, please create a new Discussion.

Members: 254
Latest Activity: Apr 1

Discussion Forum

Missing Deconstruct System and Deconstruct Quelea 1 Reply

Hello, I have been trying to follow this tutorial …Continue

Started by Bara'a Usama. Last reply by Jack D Feb 23, 2023.

literature review

Writing a literature review is a common task for academics and students, but it’s also one of the most challenging ones. Poorly written reviews can expose a lot of plagiarism and bring down your…Continue

Started by Barry I. Bradt Sep 21, 2022.

Avoid Obstacle Force 4 Replies

HiI am a  student at University of Tabriz in Iran.I want to use Quelea for my thesis,but i have a problem with Avoid obstacle force as you seen in attach file. Could you help me?Continue

Started by azam ghasemi. Last reply by SarahBrunning Jul 13, 2020.

Quelea Polysurface Environment Problem

Hello Everyone,I have been using quelea for the past month, so I am still familiarizing.I have created a polysurface in rhino which represents my roof.I am trying to use particles to simulate…Continue

Started by Alexandra Kalymniou Nov 22, 2018.

Comment Wall


You need to be a member of Quelea - agent-based design for Grasshopper to add comments!

Comment by ckmok on August 29, 2020 at 10:44am

Hi Alex, I downloaded some examples on Github, but I think these examples were only for Agent not the most updated Quelea version (beta 0.2).  I tried to download some examples on the following

But I was report fatal error.  Are there any examples for most updated Quelea version (beta 0.2)?


Comment by doolittles on April 8, 2019 at 9:12pm

Can anyone please help me solve why the flow on surface definition that I followed according to the tutorial doesn't seem to be doing the water simulations correctly on my hypar model? 

Will be gratefully appreciated!


Comment by Puree on February 19, 2018 at 8:26pm

Hi I'am architecture student of KMITL form Thailand.I wanna to write script about phototaxis of algae to their food ex. I have start point(Emiter) and agent will move to Food point and division itself.How to write the script? Thank you

Comment by Paris N on July 4, 2017 at 3:05pm

Hello Alex and everyone

Quelea is great. Thanks for sharing.

I was struggling with the combination of 2 or 3 quelea systems, I would like to have the output particules position from the 1st system as enviroment for another system. I have managed to make a working solution.

My problem is on 2nd system. It only gives me the results i want (number of particules, position and velocity) when engine is set to reset, thus not being able to produce cuntinuous behavior.

I recreated the file a couple of time to avoid mistakes. but still the same. Maybe my poor knowledge of the plugin or a code bug? I attached the gh file and a screenshot for a general view. Any suggestion is welcome. Thanks in advance.

Comment by Sean Holden on January 14, 2017 at 12:02pm

Hi Alex, and all,

I am having a lot of fun with this plugin but am struggling with the 'follow path force' function. I want particles to be emitted from the bottom of this tree structure and flow up through its paths smoothly/randomly. I have attached the file if anyone happens to have any time to have a quick look at it - I feel like I am getting there - just a bit out of my depth.

Thank you very much in advance for your help, 


Comment by Ben on December 10, 2016 at 10:39am

Hi Alex, I am really interested in your work! I have rather an abstract question for you as my project is still pretty loosely defined. Basically, have you seen anything done between Quelea and Karamba? I really liked you therma example where the lines where influenced by the solar data out of diva. I have a similar set up using Karamba and shells, where I get stress lines and deflection information. I was wondering if I could use agent based modelling to have lines becoming influences by, say, areas of higher stress? Or possible follow stress lines? 

Comment by Chris on August 17, 2016 at 2:30pm
Hi Alex.. I've just started to have a look at quelea, looks fantastic.. I'm very interested in looking at spectator movement in sports venues.. Initially on the horizontal plane.. And then out of the bowl. Do you have any basic scrips set up for crowd flows... Or any advice you could offer would be very welcome.. Thanks C
Comment by CathyTs on June 15, 2016 at 4:00pm

Hello! i want to make a crowd simulation in a public space! I saw something really interesting in your video and it is exactly what I want to achieve: I have a plavn view of a park with obstacles and so on and want to show people's movement. How is it possible?

Comment by Syafiq Azmy on March 28, 2016 at 9:19pm

Hello all, is there any example of scripts I can follow if I wanna do preview when each rule applied and temporal variations weights of forces over time?

Comment by toufeeque abdul on February 8, 2016 at 6:28pm

Hi Alex,

First of all thank you for the amazing plugin.

I had a similar issue like Don Reilly, I am looking into branching  initiated by collision of the quelea with the environment (setting up new emitters in points of collision). I am unable to record the points of collision. Could u please help me figure out a way to record and use the points of collision. Thanks.


Members (254)






  • Add Videos
  • View All

© 2024   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service