turtles, patches, and links for kids, teachers, and scientists
HTML Scala Java NetLogo XSLT Shell CSS
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.idea IntelliJ xml files Apr 25, 2017
Mathematica-Link @ 6357f0d Update Mathematica Link & arduino, cf extensions Mar 2, 2018
autogen Docs: Update Tools menu image for System Dymanics tutorial Aug 16, 2018
behaviorsearch @ 8cfa53d Update behaviorsearch Mar 16, 2018
bin make issues script run on latest sbt, Scala May 7, 2018
dist Add Windows version properties file Jun 4, 2018
extensions Merge pull request #1636 - add an extensions manager Jul 5, 2018
mac-app/src/main/java/org/nlogo/app Bundle BehaviorSearch on Mac Dec 20, 2016
macros/src/main ParserJS builds using snapshot of scala-parser-combinators Nov 18, 2016
models @ 27742f7 Update models library commit for version changes Jun 4, 2018
netlogo-core/src Have a separate sub-dir inside the per-user dir for each minor version Jul 23, 2018
netlogo-gui [Libraries Dialog] Remove tab bar Aug 13, 2018
netlogo-headless Add up-to-n-of to headless Jul 30, 2018
parser-core/src Rename at-most to up-to-n-of and add tests Jul 30, 2018
parser-js/src/main Clean unused imports Jul 5, 2017
parser-jvm/src Add _uptonof to syntax tests Jul 30, 2018
project Document the Extension Manager, including updates to existing pages Aug 16, 2018
shared Rename at-most to up-to-n-of and add tests Jul 30, 2018
test Tests: List prims can take fractional indexes Aug 13, 2018
.gitattributes add a .gitattributes file to the repo for proper eol conversion Aug 7, 2012
.gitignore IntelliJ xml files Apr 25, 2017
.gitmodules Infrastructure: Get CF from NetLogo GitHub URL Aug 9, 2018
Jenkinsfile Update Jenkinsfile to work around strange Jenkins + git behavior Jul 18, 2017
NetLogo.iml Update scala SDK version in intellij Jan 31, 2018
README.md Update netlogo-users links to new Google Groups home May 11, 2018
build.sbt Merge pull request #1636 - add an extensions manager Jul 5, 2018
classycle.sbt Upgrade to sbt 1.0 Feb 8, 2018
nightly.sh Nightly uses renamed test commands Oct 6, 2015
sbt Update sbt version to 1.1.1 Feb 20, 2018



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

Other users should visit the NetLogo home page at Northwestern 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.

Reporting Bugs

If you have encountered a bug in the latest version of NetLogo, it might be worth checking the Known 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 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 Netlogo-Users Google group frequently tackles questions on modeling. Be aware that the the group is moderated, so most messages don't go through until at least the next business day. There is also a fairly active NetLogo community on StackOverflow. NetLogo Users tends to be a better place to ask more open-ended modeling questions, for instance "I'm interested in making a model of plate tectonics, can anyone offer advice?". StackOverflow tends to be best for asking specific questions with definite answers, for instance "How can I create a small-world network of turtles and links?".

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. If you're a developer of an existing extension and interested in porting it to NetLogo 6, please see the 6.0 transition guide. 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!

Google Summer of Code

We're very excited to have been accepted to Google Summer of Code 2017 as a mentoring organization! We're even more excited that you're interested in contributing to NetLogo this summer. Please join us in our GSoC 2017 chat room if you have specific questions or are just interested in chatting. Student applications will open up on GSoC on March 20th, and that will be everyone's opportunity to formally declare their interest in working on NetLogo, and what projects they would like to contribute to. Guidelines for what we would like to see in proposals are covered on our organization page.

Please note that an accepted contribution to NetLogo or NetLogo Web is necessary for an application to be considered. Before working on a contribution, please discuss it with us in the GSoC 2017 Gitter channel. This helps us stay on top of things and might save you time working on something that someone else is already planning to do!

For Other Help

Please ask us!

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


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.