Skip to content

Studio Dashboard

WorldSim includes a built-in web dashboard for real-time simulation monitoring:

bash
npx worldsim studio
# Open http://localhost:4400
# Optional: --port 5000, --no-open
  • Live agent state — mood, energy, goals, status
  • Event timeline — every action, every tick
  • Relationship graph — force-directed visualization of social connections
  • Simulation report — mood heatmaps, energy charts, action distribution, timeline
  • Multi-world operations — monitor and compare multiple world runs (city/country shards)

Main sections

  • Agents — inspect profile, current status, goals, mood and energy in real time
  • Timeline — follow what happens at each tick, with a chronological event stream
  • Perception — when interaction.mode === "perception": live stimuli on the bus, open topics, ranked percepts and active needs per agent (see Perception Layer)
  • Relationship Graph — visualize who influences whom and how social ties evolve
  • Report — review post-run metrics, trends, and behavior distribution

Programmatic setup

typescript
import { studioPlugin } from "worldsim";

engine.use(studioPlugin({ engine, port: 4400, memoryStore, graphStore }));

UI Examples

Relationship Graph view (real-time social connection map):

Relationship Graph

Agent Details view (profile, internal state, and memory timeline):

Agent Details

Released under the MIT License.