๐ ๏ธ Installation
๐๏ธ Requirements
Please make sure your system meets the following specs:
- OS: Ubuntu 20.04+ / Windows 10+
- RAM: 32GB+
- GPU: NVIDIA RTX 2070+
- VRAM: 8GB+
Why these specs?
OmniGibson
is built upon NVIDIA's Omniverse and Isaac Sim platforms, so we inherit their dependencies. For more information, please see Isaac Sim's Requirements.
๐ป Setup
There are two ways to setup OmniGibson
:
- ๐ณ Install with Docker (Linux only): You can quickly get
OmniGibson
immediately up and running from our pre-built docker image. - ๐งช Install from source (Linux / Windows): This method is recommended for deeper users looking to develop upon
OmniGibson
or use it extensively for research.
Install OmniGibson
with Docker is supported for ๐ง Linux only.
Need to install docker or NVIDIA docker?
# Install docker
curl https://get.docker.com | sh && sudo systemctl --now enable docker
# Install nvidia-docker runtime
distribution=$(. /etc/os-release;echo $ID$VERSION_ID) \
&& curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | \
sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg \
&& curl -s -L https://nvidia.github.io/libnvidia-container/$distribution/libnvidia-container.list | \
sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt-get update
sudo apt-get install -y nvidia-docker2 # install
sudo systemctl restart docker # restart docker engine
-
Install our docker launching scripts:
curl -LJO https://raw.githubusercontent.com/StanfordVL/OmniGibson/main/docker/run_docker.sh chmod a+x run_docker.sh
What is being installed?
Our docker image automatically ships with a pre-configured conda virtual environment named
omnigibson
with Isaac Sim andOmniGibson
pre-installed. Upon running the first time, our scene and object assets will automatically be downloaded as well. -
Then, simply launch the shell script:
<ABS_DATA_PATH>
specifies the absolute path data will be stored on your machine (if no<ABS_DATA_PATH>
is specified, it defaults to./omnigibson_data
). This needs to be called each time the docker container is run!
Are you using NFS or AFS?
Docker containers are unable to access NFS or AFS drives, so if
run_docker.sh
are located on an NFS / AFS partition, please set<DATA_PATH>
to an alternative data directory located on a non-NFS / AFS partition.
Install OmniGibson
from source is supported for both ๐ง Linux (bash) and ๐ Windows (powershell/cmd).
-
Install Conda and NVIDIA's Omniverse Isaac Sim
The latest version of Isaac Sim (2022.2.1) has known issues when loading large
OmniGibson
scenes. Please install 2022.2.0 instead.For Ubuntu 22.04, you need to install FUSE to run the Omniverse Launcher AppImage.
-
Clone
OmniGibson
and move into the directory:Nightly build
The main branch contains the stable version of
OmniGibson
. If you want to be up-to-date with our latest developed (yet not fully tested) features and bug fixes, you can clone from theog-develop
branch. -
Setup a virtual conda environment to run
OmniGibson
:- The script will ask you which Isaac Sim to use. If you installed it in the default location, it should be
~/.local/share/ov/pkg/isaac_sim-2022.2.0
This will create a conda environment with
omnigibson
installed. Simply callconda activate
to activate it. - The script will ask you which Isaac Sim to use. If you installed it in the default location, it should be
-
Download
OmniGibson
dataset (within the conda env):
-
Install Conda and NVIDIA's Omniverse Isaac Sim
The latest version of Isaac Sim (2022.2.1) has known issues when loading large
OmniGibson
scenes. Please install 2022.2.0 instead. -
Clone
OmniGibson
and move into the directory:Nightly build
The main branch contains the stable version of
OmniGibson
. If you want to be up-to-date with our latest developed (yet not fully tested) features and bug fixes, you can clone from theog-develop
branch. -
Setup a virtual conda environment to run
OmniGibson
:- The script will ask you which Isaac Sim to use. If you installed it in the default location, it should be
C:\Users\<USER_NAME>\AppData\Local\ov\pkg\isaac_sim-2022.2.0
This will create a conda env with
omnigibson
installed. Simply callconda activate
to activate it. - The script will ask you which Isaac Sim to use. If you installed it in the default location, it should be
-
Download
OmniGibson
dataset (within the conda env):
๐ Explore OmniGibson
!
Expect slowdown during first execution
Omniverse requires some one-time startup setup when OmniGibson
is imported for the first time.
The process could take up to 5 minutes. This is expected behavior, and should only occur once!
OmniGibson
is now successfully installed! Try exploring some of our new scenes interactively:
- This demo lets you choose a scene and interactively move around using your keyboard and mouse. Hold down
Shift
and thenLeft-click + Drag
an object to apply forces!
You can also try teleoperating one of our robots:
- This demo lets you choose a scene, robot, and set of controllers, and then teleoperate the robot using your keyboard.
Next: Get quickly familiarized with OmniGibson
from our Quickstart Guide!
๐งฏ Troubleshooting
I cannot open Omniverse Launcher AppImage on Linux
You probably need to install FUSE to run the Omniverse Launcher AppImage.
OmniGibson is stuck at shader compilation upon startup
The process could take up to 5 minutes. This is expected behavior, and should only occur once when you import OmniGibson for the first time.
OmniGibson is stuck at HydraEngine rtx failed creating scene renderer.
OmniGibson
is likely using an unsupported GPU (default is id 0). Run nvidia-smi
to see the active list of GPUs, and select an NVIDIA-supported GPU and set its corresponding ID when running OmniGibson
with export OMNIGIBSON_GPU_ID=<ID NUMBER>
.