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: 248
Latest Activity: Sep 21

Discussion Forum

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.

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.

Missing Deconstruct System and Deconstruct Quelea

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

Started by Bara'a Usama Mar 16, 2019.

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 Petar Pejic on June 21, 2015 at 2:40am


I managed to figure something out, however, the performance is quite bad at this point. Maybe it could be optimizes? Anyhow, I am sharing it for other people to find it helpful as well.

Comment by ng5 Alex on June 20, 2015 at 11:54am

Hello all!.

since some comments are not congrats etc, but have to do with the plugins applications, could you please post these as discussions of the group, in order to find them easier, for future reference?.

thank you



Comment by Alex Fischer on June 20, 2015 at 11:26am

Do you have a grasshopper file I can look at?

Comment by Petar Pejic on June 19, 2015 at 4:44am

Let me try to explain it better:

I would have 5 points acting as point emitter. I would like for each one of them to emit 3 different particles (let's say red, green and blue). For the sake of explanation, set us assume that they are emitted randomly. Furthermore, I would for all of them to interact based on swarm behaviour, but each colour would have different point attractor. I hope it is clear now.

Also, I would like to limit movement to x and y axis, and allow for z movement only in certain region. I managed to do it with custom force, but it seams to really slow down the analysis. is there maybe an other way? 

Thank you for your help, it is highly appreciated. 

Comment by Alex Fischer on June 18, 2015 at 11:26am

Hi Petar, I'm not entirely sure what you're asking, but I think the answer is yes. You can certainly have each agent be attracted to a different point, just feed in a list of points that match each agent to the Attract component. You can also have another system of particles act as attractors, just get their position and feed it into the Attract component. You can also have each agent be emitted from a different room and have them be attracted to a specific room. You can also send me your script if you need more help.



Comment by Petar Pejic on June 18, 2015 at 7:02am

Hi Alex,

Would it be possible to to have multiple attractor points for agents emitted from one particle? The idea behind this is to establish different user groups where each one of them is attracted to different program. After, multiple emitters could be introduced .

Comment by Igor on June 16, 2015 at 1:47pm

Hi Alex,

I have similar problems like this

The site normally doesn't work with one of browsers. Many thanks for the help.

Comment by Alex Fischer on June 15, 2015 at 8:49pm

Hi Igor,

Could you explain what does not work about food4rhino. It works for me but if there is a problem I would like to let them know.


Comment by Igor on June 15, 2015 at 11:18am

Hi Alex,

Whether it is possible to download the Quelea somewhere else? The site food4rhino unfortunately doesn't work properly and it is impossible to download the Quelea from it.

Comment by Alex Fischer on June 2, 2015 at 8:44pm

Hi Igor,

Thanks! I currently do not have mesh environments implemented, but its on my todo list. You can find some example scripts on the quelea website that includes a rainflow demo. I would love to see what you are working on once you're done.

And thank you Amir, it is very nice to hear that you and others are appreciating it so much!



Members (248)






  • Add Photos
  • View All

© 2022   Created by Scott Davidson.   Powered by

Badges  |  Report an Issue  |  Terms of Service