Local Interface for simulation definition, management, and analysis. Local Interface is a part of the Agents Assembly ecosystem. Other applications are:
- Simulation Run Environment - scalable run environment for Agents Assembly.
- Communication Server - cluster of servers used for XMPP communication.
- Agents Assembly Translator - translator for Agents Assembly code.
- Local Development Environment - simple environment for running agent-based simulations.
docker
docker-compose (dev only)
To use the application, utilize the server.sh script.
First, initialize the cluster:
./server.sh init
Alternatively, join the existing cluster using the TOKEN received from the init command:
./server.sh join TOKEN
Then, create the required networks (this step needs to be done only once inside the cluster):
./server.sh network
Finally, start the application:
./server.sh start
After starting, the application is available at http://localhost:80.
To see all the available options run the help command:
./server.sh help
The application must be used with the dedicated simulation run environment, described in About
The structure of the local interface is presented below.
React.js app used as GUI. It handles user interaction with the system.
Environment variables:
CHOKIDAR_USEPOLLING- reload application after detecting a change in source files (i.e., true); if set to true, it requires the following volume attached: user-interface/src:/app/srcPORT- listen port (must be 80)
Nginx instance that provides a gateway to the Simulation Run Environment.
Host port mapping:
- port
80- access to user interface and simulation run environment API (/api)
Host port mapping (dev only):
- port
8008- simulation run environment database connection (neo4j)
Please follow the contributing guide if you wish to contribute to the project.