Crowd UI

Crowd is a social network simulation framework which simplifies and fastens the process of developing agent-based models and simulations on networks. It is developed as a Python library, which also provides more advanced visualization through its graphical user interface. In this repository, you can find the source code of Crowd’s GUI, written with web technologies but wrapped as a desktop app which can be easily installed and run. Installers can be found on “Releases” section. 

Steps to Set Up Crowd’s UI:

Prerequisites

Ensure you have Python 3.12 installed on your system. If not, follow these steps to install it:

• Visit the official Python downloads page: https://www.python.org/downloads/

• Download the installer for Python 3.12 suitable for your operating system.

• Run the installer and ensure you select the option Add Python to PATH during installation.

Step 1: Download the Crowd Python Library

• Navigate to the Crowd GitHub repository: https://github.com/bilkent-sna/crowd

• Clone or download the repository to your local system:

  • To clone using Git, run: git clone https://github.com/bilkent-sna/crowd

  • Alternatively, click Code > Download ZIP and extract it to a preferred location.

Step 2: Download and Install Crowd UI

• On this repository, go to the releases page: https://github.com/bilkent-sna/crowd-ui/releases/tag/v0.9.0

• Locate the latest release (v0.9.0) and download the installer. 

• Run the installer and follow the on-screen instructions to complete the installation.

Step 3: Run Simulations with Crowd

Once the installation is complete, you can start using Crowd's GUI to configure and run simulations:

• Launch the Crowd app from your desktop or application menu.

• Create your first project, configure simulation settings and run simulations.

• For detailed usage and features, refer to Crowd's documentation. 

If you encounter any issues -> open an issue on this repository.

Citation

Please cite the following paper if you use Crowd:

@article{rende2025crowd,
   title={Crowd: A Social Network Simulation Framework},
   author={Rende, Ann Nedime Nese and Yilmaz, Tolga and Ulusoy, Ozgur},
   journal={IEEE Transactions on Computational Social Systems},
   year={2025},
   publisher={IEEE},
   doi={10.1109/TCSS.2025.3565377}
}