ev-sim

This is our in-house simulation environment for testing and developing algorithms for autonomous driving. It is built on top of three.js and provides a visual scripting interface for creating and running simulations.

Quick Start

One-liner (clones the repo and installs dependencies):

curl -fsSL https://raw.githubusercontent.com/cornellev/ev-sim/main/install.sh | bash

Then:

cd ev-sim
npm run dev

Or install into a custom directory and start immediately:

curl -fsSL https://raw.githubusercontent.com/cornellev/ev-sim/main/install.sh | bash -s -- --dir ~/ev-sim --start

Already have the repo cloned?

npm install
npm run dev

The app opens to the simulation workspace by default. Press Escape to open the app menu, where you can see options such as:

Environment Editor

Visual Scripting ("Canvas")

Log Analysis and Telemetry

Vehicle Editor

Agent plugin (portable skill + MCP)

This repository is an Agent Plugin: root plugin.json, mcp.json, and skills/cev-sim/. Importing it gives agents an auto-invoked cev-sim skill and registers the Streamable HTTP MCP endpoint http://localhost:3000/mcp.

Import does not start the app. Run npm run dev (or npm start) before MCP discovery. Server id is always cev-sim.

Ways to load the plugin:

• Git URL / marketplace import of this repo
• Cursor CLI: agent --plugin-dir /path/to/this/repo
• Local copy or symlink into ~/.cursor/plugins/local/cev-sim, then reload the window

Manual MCP-only fallback (without the plugin): see MCP Server.

Validate the portable bundle:

node skills/cev-sim/scripts/validate.mjs

Documentation

• Documentation index
• Getting started
• Architecture
• Environment editor
• Earth import
• Development workflow
• Visual scripting
• Simulation
• Telemetry, logging, replay, and analysis
• ROS integration
• MCP Server (agent tooling)
• Assets
• Troubleshooting

CommonRoad Scenarios

Download scenarios from https://gitlab.lrz.de/tum-cps/commonroad-scenarios and place the scenarios folder in public/, creating public/scenarios.

Example browser path:

/scenarios/DR_CHN_Merging_ZS_1_T_1.xml

See Assets for asset policy and setup details.

References

M. Althoff, M. Koschi, and S. Manzinger, "CommonRoad: Composable Benchmarks for Motion Planning on Roads," in Proc. of the IEEE Intelligent Vehicles Symposium, 2017, pp. 719-726.