๐ ๏ธ 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. (1)- ๐ Worried about dataset size? We will ask whether you want to install our small demo dataset or full dataset of assets!
-
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 (cmd).
-
Install Conda
-
Install NVIDIA's Isaac Sim platform (1)
The latest version of Isaac Sim (2022.2.1) has known issues when loading large
OmniGibson
scenes. Please install 2022.2.0 instead.Depending on the OS, you might need to install FUSE to run the Omniverse Launcher AppImage.
-
Export IsaacSim directory path as an environment variable: (2)
-
Clone
OmniGibson
and move into the directory: -
Setup a virtual conda environment to run
OmniGibson
:This will automatically create an dump you into a conda env called
omnigibson
. If you need to activate this environment later, simply call:Note for zsh users
bash is strongly recommended on Linux. If you are using zsh, you need to change
${BASH_SOURCE[0]}
and${BASH_SOURCE}
to$0
in the first line of<ISAAC_SIM_PATH>/setup_conda_env.sh
and<ISAAC_SIM_PATH>/setup_python_env.sh
respectively in order forOmniGibson
to work properly. -
Download
OmniGibson
assets and datasets: -
๐ Congrats! You installed
OmniGibson
successfully.
-
Be sure keep track of where you choose Omniverse to write package files! By default this should be
~/.local/share/ov/pkg
-
If you installed Isaac Sim to the default location, this is
~/.local/share/ov/pkg/isaac_sim-2022.2.0
-
Install Conda
-
Install NVIDIA's Isaac Sim platform (1)
The latest version of Isaac Sim (2022.2.1) has known issues when loading large
OmniGibson
scenes. Please install 2022.2.0 instead. -
Export IsaacSim directory path as an environment variable: (2)
-
Clone
OmniGibson
and move into the directory: -
Setup a virtual conda environment to run
OmniGibson
:This will automatically create an dump you into a conda env called
omnigibson
. If you need to activate this environment later, simply call: -
Download
OmniGibson
assets and datasets: -
๐ Congrats! You installed
OmniGibson
successfully.
-
Be sure keep track of where you choose Omniverse to write package files! By default this should be
C:\Users\<USER_NAME>\AppData\Local\ov\pkg
-
If you installed Isaac Sim to the default location, this is
C:\Users\<USER_NAME>\AppData\Local\ov\pkg\isaac_sim-2022.2.0
๐ Explore OmniGibson
!
Expect slowdown during first execution
Omniverse requires some one-time startup setup (up to ~5 minutes) when OmniGibson
is imported for the first time. 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!