Skip to content

danielvartan/logopak

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

21 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

LogoPak

Project Status: Active – The project has reached a stable, usable state and is being actively developed. DOI Badge build-flatpak.yaml FAIR checklist badge fair-software.eu GPLv3 License Badge Contributor Covenant 3.0 Code of Conduct

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! Β  GitHub Repository Stars

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//24.08 org.freedesktop.Sdk//24.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

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

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

Contributor Covenant 3.0 Code of Conduct

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.

GitHub Sponsor

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

License: GPLv3

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.