Install

Requirements

• Python 3.11 or newer.
• No GPU. Your jobs run on Simulo’s cloud GPUs.

Install

pip install simulo

This one package gives you import simulo for writing apps and the simulo command for submitting and following jobs. It installs no PyTorch, CUDA, or simulator. Your app imports them inside with app.runtime.imports():. On your computer, Simulo only records those imports; they run on the cloud GPU. See Create your first app.

pip also installs a few small dependencies: simulo-interfaces (shared definitions simulo is built on), mcap (reads downloaded recordings), defusedxml (reads URDF files safely), and usd-core (reads USD files when you publish your own assets).

To update an existing install:

pip install --upgrade simulo

Check the install

simulo --version
simulo --help

simulo --help lists every command. If your shell says simulo isn’t found, the directory pip installs scripts into isn’t on your PATH. pip prints that directory as a warning during the install; add it to PATH, open a new shell, and try again.

Download the samples

If you have Git, you can download Simulo’s sample apps without signing in:

simulo install samples
cd simulo-samples

This clones the samples repository into ./simulo-samples, with full history. Open its README.md to see what’s there.

To clone somewhere else, or check out a specific branch, tag, or commit:

simulo install samples --directory robotics-examples --ref main

The destination must not exist yet, and its parent directory must. See the command reference for details.

Next

Log in so simulo run can submit jobs to the cloud.