Agentyx

A high-performance, cross-backend agent-based simulation engine for the web.

Agentyx provides a custom DSL for agent behavior, then compiles it for JavaScript, WebWorkers, WebAssembly, and WebGPU execution.

Install

npm i @websimbench/agentyx

Documentation

The documentation is hosted in WebSimBench.

https://websimbench.dev/#/docs/latest/overview

Quick Start

import { Simulation } from "@websimbench/agentyx";

const canvas = document.getElementById("my-canvas") as HTMLCanvasElement;

const simulation = new Simulation({
  canvas,
  source: {
    kind: "dsl",
    code: `
      input speed = 2;
      input turnAngle = 0.5;

      moveForward(inputs.speed);
      turn(inputs.turnAngle);
      borderWrapping();
    `,
  },
  options: { agents: 5000 },
});

await simulation.initGPU();

async function runLoop() {
  await simulation.runFrame("WebGPU", { speed: 3, turnAngle: 0.2 }, "gpu");
  requestAnimationFrame(runLoop);
}

runLoop();

Examples

Check out the following examples in the examples/ directory to see Agentyx in action. These can be run directly in your browser without a build step:

Basic Setup

• JavaScript Backend
• WebWorkers Backend
• WebAssembly Backend
• WebGPU Backend

Features

• Advanced Demo
• Benchmark Data
• Changing Style
• FPS Counter
• Realtime Sliders