Skip to main content

Prerequisites

Before installing the web platform, ensure you have all required dependencies installed on your system.

Node.js​

Visit the official Node.js website and download the installer for your operating system.

Verify the installation:

$ node -v
v25.6.1
info

Node.js v24 or later is required

Android Debug Bridge (ADB)​

ADB enables command-line interaction between your computer and Android devices, including VR headsets. It's also required for streaming headset displays to the web platform.

Installation Options​

macOS (Homebrew)

Install Homebrew if needed: brew.sh

brew install android-platform-tools
Manual Installation (All Platforms)
  1. Download the Android Platform Tools from developer.android.com
  2. Extract to a permanent location:
    • macOS/Linux: /usr/local/platform-tools/
    • Windows: C:\platform-tools\
  3. Add to your system PATH

macOS/Linux:

echo 'export PATH=$PATH:/usr/local/platform-tools' >> ~/.zshrc
source ~/.zshrc

Windows:

  1. Press Windows Key and search for "Edit the system environment variables"
  2. Click "Environment Variables"
  3. Under "User variables", double-click "Path"
  4. Click "New" and add the platform-tools path
  5. Click "OK" and restart terminals

Verify the installation:

$ adb version
Android Debug Bridge version 1.0.41
Version 35.0.2-android-tools
Installed as /usr/bin/adb
Running on Linux 6.18.9-arch1-2 (x86_64)

GAMA Platform​

The GAMA platform runs the virtual universe simulations.

Installation​

  1. Download from gama-platform.org
  2. Follow the official installation guide

Configuration​

Default WebSocket settings:

  • Address: localhost
  • Port: 1000

To modify these in GAMA: Support → Preferences → Network → Server Mode

warning

Ensure the web platform's .env settings (GAMA_WS_PORT and GAMA_IP_ADDRESS) match your GAMA configuration.

SIMPLE Plugin​

Follow the instructions in the GAMA Plugin Repository to install the SIMPLE plugin.

Next Step​

With dependencies installed, proceed to Install the Web Platform.