README.md

Multiverse-Docker

This repository provides an example of how to execute Multiverse Framework within a Docker environment.

You can operate the Multiverse Framework with Docker in two ways: on the cloud or locally.

Run Multiverse Docker on the Cloud using BinderHub

• Link to the BinderHub

For the IROS2025 experiments, you can quickly access these Jupyter Notebooks:

• Universal Scene Description Parser Experiment (for URDF, MJCF and USDA as input)
• Universal Scene Description Parser Experiment (for ProcTHOR as input)
• Competency Questions Experiment

Run Multiverse Docker locally

Prerequisites

Ensure that you have Docker installed.

Verify your versions of docker and docker compose by running:

$ docker -v
Docker version 27.1.2, build d01f264
$ docker compose version
Docker Compose version v2.29.1

1. Set up Docker

Run the following commands to clone the repository and configure Docker:

git clone https://github.com/Multiverse-Framework/Multiverse-Docker.git && cd Multiverse-Docker
./setup_images.bash
docker compose pull

2. Start the Docker Compose service

To start the service, run the following command:

docker compose up

Once the service is running, open your browser and navigate to http://127.0.0.1:8888/lab.

From there, you can either click on "Desktop" to access the virtual machine, or stay in the Jupyter notebook interface to explore and run tutorials.

The interface should appear similar to this: