NetLogo

This page is for open source developers interested in the source code for NetLogo.

Other users should visit the NetLogo home page, the NetLogo Forum and the NetLogo users group on Google.

The most recent version of NetLogo can be downloaded here.

I Need Help! Where Do I Look?

This depends on what you need help with. The NetLogo community have several different channels for communicating and the best way to get help quickly is to address your request to the proper channel.

• I have encountered a bug
• I am learning NetLogo and would like help
• I am trying to model something or extend a model
• I have a suggestion for a new feature
• I am developing an extension or using the controlling API and would like support
• I would like to build NetLogo from source
• I need help for some other reason

Reporting Bugs

If you have encountered a bug in the latest version of NetLogo, it might be worth checking the Issues page to see if other users have already reported the issue. If no one has reported the issue, please open a GitHub issue or email our bugs list. If possible, please include a model displaying the bug as well as information about what you were doing when the issue occurred. Including the model and information about the buggy interaction makes fixing the problem much easier and ensures we fix the exact problem you were experiencing. If the model isn't public, please send it to our bugs mailing list. This list is private and your model will not be shared publicly.

Learning NetLogo

We're excited that you're learning NetLogo! NetLogo comes with a tutorial which introduces the basic concepts and can help you get started. If you're looking for a textbook which explains the concepts underlying NetLogo you might look at An Introduction to Agent-Based Modeling available as a paper book and/or ebook from MIT Press. The archives of an intro courses on NetLogo titled "Introduction to Agent-Based Modeling" are available on Complexity Explorer.

Help with Modeling

There are many good resources listed on the NetLogo resources page

The best place to ask questions is the NetLogo Forum.

The Netlogo-Users Google group frequently tackles questions on modeling, but be aware that the group is moderated, so most messages don't go through until at least the next business day.

Suggestions for New Features

While the resources we have to add new features are limited, we're happy to hear new ideas! You might quickly search our issue tracker to see if someone has suggested something similar in the past (if you find something, comment on the issue to let us know it's something people are interested in). Otherwise, please open an enhancement request on GitHub or email our feedback list.

Extension API and Controlling API support

A good place to start is in our wiki. For extension developers, see the page on the extensions API. There is also a wiki page on the controlling API.

Often extension and embedding developers have fairly specific questions. We encourage those developers to post to the netlogo-devel Google Group or join us on Gitter.

Building from source

Our goal is that users are able to build NetLogo from source on their platform of choice (Mac, OS X, or Linux). More information can be found on our Building wiki page. If the information on this page doesn't work for you or you have trouble or are confused, please post to netlogo-devel Google Group or join us on Gitter and request help. We're trying to make building NetLogo easy, so we would love to hear any suggestions you have or problems you encounter!

For Other Help

Please ask us!

You can email our feedback list or ask your question on Gitter.

Issues

We've all got them. NetLogo's are here: https://github.com/NetLogo/NetLogo/issues

Developer documentation

...is in the wiki.

Discussion group

To talk about NetLogo development, NetLogo internals, the NetLogo source code, usage of NetLogo APIs, etc., join netlogo-devel at Google Groups.

Package repository hosting is graciously provided by Cloudsmith.