netlogo-actions: GitHub Actions for the NetLogo Community 🚀

[Daniel Vartanian]

Hi everyone!

I’m excited to share my new NeLogo project: netlogo-actions, a set of GitHub Actions that can be used to automate testing and execution of NetLogo models within GitHub workflows. I hope the community finds it useful!

Right now the repository includes the setup-netlogo action, which installs NetLogo on the runner.

There are several workflow examples you can build from. You can also see setup-netlogo in use on this repository’s actions page. This action can be combined with Quarto through the logolink R package or pynetlogo for more advanced workflows. For an example, see netlogo-check.

Here’s a basic workflow:

jobs:
  NetLogo-check:
    runs-on: ubuntu-latest
    permissions: read-all
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v4

      - name: Setup NetLogo
        uses: danielvartan/netlogo-actions/setup-netlogo@v1

      - name: Run Experiment
        run: |
          MODEL_PATH="$NETLOGO_HOME/models/Sample Models/Biology"
          MODEL_FILE="Wolf Sheep Predation.nlogox"

          netlogo \
            --headless \
            --model "$MODEL_PATH/$MODEL_FILE" \
            --experiment "Wolf Sheep Crossing" \
            --table /tmp/output.csv

          cat /tmp/output.csv

You can learn more at: https://github.com/danielvartan/netlogo-actions

Happy modeling with NetLogo! :)

Cheers!

Daniel Vartanian