Installation¶

simrun needs python 3.14 or newer and runs on Linux. The same package is the client (the command line simrun and the MCP server simrun-mcp), the service and the harness of the pods (simrun-worker, simrun-merge, simrun-exec). Install it from PyPI with pip:

pip install simrun

With uv¶

With uv, install the command line as a tool:

uv tool install simrun

add simrun to a project, e.g. the one of a plugin, which locks it together with the rest of the environment:

uv add simrun

or run it from a checkout of the repository, which is how the MCP server of an agent is usually registered (see Agents and MCP):

git clone https://github.com/matthiaskoenig/simrun.git
uv run --project simrun simrun --help

Check the installation¶

simrun --help
python -c "import simrun; print(simrun.__version__)"

The command line needs a running service, see Command line, or runs everything on this machine with --local, see Local mode; the service and the cluster are set up as described in Cluster deployment.

Optional packages¶