LogoPak

LogoPak is a Flatpak package for NetLogo, a multi-agent programmable modeling environment for simulating natural and social phenomena. It simplifies the installation and management of NetLogo on Linux systems.

The package includes all four NetLogo applications (NetLogo, NetLogo 3D, HubNet Client, and BehaviorSearch) and registers desktop files, file icons, and MIME types for NetLogo model files, enabling users to use NetLogo like any other native application on their system.

If you find this project useful, please consider giving it a star!  

Installation

LogoPak is not yet available on Flathub. To install it, you can download and install the pre-built bundle or build it locally from source. This assumes you have Flatpak installed on your system.

The current version of NetLogo included in LogoPak is NetLogo 7.0.4.

Using the Pre-built Bundle

The easiest way to install LogoPak is by using the pre-built Flatpak bundle:

1. Download the latest Flatpak bundle from the releases page.
2. Install the bundle by running the following command in your terminal:

flatpak install --user logopak.flatpak

Building from Source

Prerequisites

To build LogoPak from source, you'll need Flatpak and flatpak-builder on your system. After installing these tools, start by cloning this repository:

git clone https://github.com/danielvartan/logopak

Next, add the Flathub repository if you haven't done so already:

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Now install the required runtime and SDK:

flatpak install flathub org.freedesktop.Platform//25.08 org.freedesktop.Sdk//25.08 org.freedesktop.Sdk.Extension.openjdk17//25.08

Building the Flatpak

With all dependencies in place, run the following commands to build LogoPak:

cd flatpak
flatpak-builder --force-clean build-dir com.danielvartan.logopak.yaml

Installing Locally

Having built the package, you can now install it locally with:

cd flatpak
flatpak-builder --user --install --force-clean build-dir com.danielvartan.logopak.yaml

Test your installation by running:

flatpak run com.danielvartan.logopak

Creating a Flatpak Bundle

An easier way to distribute the application is by creating a Flatpak bundle. For that, run the following commands:

cd flatpak
flatpak-builder --repo=repo --force-clean build-dir com.danielvartan.logopak.yaml
flatpak build-bundle repo ../logopak.flatpak com.danielvartan.logopak

After creating the logopak.flatpak bundle, you can share it with others. Anyone can install it with:

flatpak install logopak.flatpak

Linting

Flathub runs a linter over the manifest and the built repository, and treats both warnings and errors as fatal. To run the same checks locally:

flatpak install flathub org.flatpak.Builder

cd flatpak

flatpak run org.flatpak.Builder --force-clean --sandbox --user \
  --install-deps-from=flathub --ccache \
  --compose-url-policy=full \
  --mirror-screenshots-url=https://dl.flathub.org/media \
  --repo=repo build-dir com.danielvartan.logopak.yaml

flatpak run --command=flatpak-builder-lint org.flatpak.Builder \
  manifest com.danielvartan.logopak.yaml

flatpak run --command=flatpak-builder-lint org.flatpak.Builder repo repo

Both flags matter. Without --compose-url-policy=full, the screenshot and icon URLs are written relative to a media_baseurl attribute that the linter does not resolve, and it reports appstream-external-screenshot-url and appstream-remote-icon-not-mirrored. Flathub's own builders pass both flags.

The finish-args-home-filesystem-access error is expected: NetLogo is a Swing application, so its file dialogs are not portal backed and models read and write data files wherever they live. It requires an exception from the Flathub reviewers.

See flathub/README.md for the submission files and the steps to open or update the Flathub pull request.

Running LogoPak

After installation, you can launch LogoPak from your application menu or by running the following command in your terminal:

flatpak run com.danielvartan.logopak

You can also launch the other applications with:

flatpak run --command=NetLogo3D com.danielvartan.logopak
flatpak run --command=HubNetClient com.danielvartan.logopak
flatpak run --command=BehaviorSearch com.danielvartan.logopak

You can also create an alias for easier access to NetLogo. Insert the following line into your shell configuration file (e.g., ~/.bashrc or ~/.zshrc):

alias NetLogo="flatpak run --command=netlogo com.danielvartan.logopak"

File Associations

LogoPak registers two file types, so that model files open in the application that can run them:

Type	Extensions	Opens in
application/x-netlogo	.nlogo, .nlogox	NetLogo
application/x-netlogo-3d	.nlogo3d, .nlogox3d	NetLogo 3D
application/x-behaviorsearch	.bsearch	BehaviorSearch

If a model opens in the wrong application, check whether an earlier NetLogo installation left its own definitions behind:

ls /usr/share/mime/packages/ | grep -i netlogo

A file there takes precedence over the ones a Flatpak provides. Remove it and rebuild the database:

sudo rm /usr/share/mime/packages/netlogo.xml
sudo update-mime-database /usr/share/mime

NetLogo Home Directory

To find the current location of the NetLogo home directory in your system, you need to first determine the installation path of LogoPak using the following command:

LOGOPAK_LOCATION=$(flatpak info --show-location com.danielvartan.logopak)

After that, you can set the NETLOGO_HOME and NETLOGO_CONSOLE environment variables as follows:

export NETLOGO_HOME="${LOGOPAK_LOCATION}/files/opt/netlogo"
export NETLOGO_CONSOLE="${NETLOGO_HOME}/NetLogo_Console"

Uninstalling

To remove LogoPak from your system, run the following command:

flatpak uninstall com.danielvartan.logopak

If you want to delete all associated user data as well? Add the --delete-data flag:

flatpak uninstall --delete-data com.danielvartan.logopak

Contributing

Contributions are always welcome! Whether you want to report bugs, suggest new features, or help improve the code or documentation, your input makes a difference.

Before opening a new issue, please check the issues tab to see if your topic has already been reported.

You can also support the development of LogoPak by becoming a sponsor.

Click here to make a donation. Please mention LogoPak in your donation message.

License

NetLogo is licensed under GPL-2.0-or-later. See the official NetLogo website for more information. LogoPak files are licensed under GPL-3.0-or-later:

Copyright (C) 2026 Daniel Vartanian

LogoPak is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option) any
later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see <https://www.gnu.org/licenses/>.

Acknowledgments

LogoPak is an independent project with no affiliation to NetLogo or its developers.

LogoPak brand identity is based on the NetLogo 7 brand identity.