⚙️ Installation

💻 Supported Operating Systems

✅ Windows 11
✅ Ubuntu 22.04+
⬜ macOS (not supported yet)

🖥️ Recommended Hardware

RAM: 32 GB
GPU: NVIDIA RTX Series (recommended for best performance)

📦 Download

Prebuilt packages are available at: https://www.ubicoders.com/virtualrobots

Setup - Windows

Just run "virtual_robots.exe"

Setup - Ubuntu

sudo apt install xdg-utils -y
sudo chmod +x ./virtual_robots.x86_64
./  .x86_64
or
# run "virtual_robots.x86_64" by double clicking it.

Setup - WSL

Install Vulkan (WSL graphics bridge)

bash install_wsl_graphics.bash && source ~/.bashrc

install_wsl_graphics.bash

#!/bin/bash
# 1. Install necessary drivers and diagnostic tools
sudo apt-get update
sudo apt install xdg-utils -y
sudo apt install mesa-utils mesa-vulkan-drivers vulkan-tools -y


# 2. Add GPU bridge variables to .bashrc for persistence
# We use GALLIUM_DRIVER to force the D3D12 bridge (Windows GPU)
# and VK_ICD_FILENAMES to ensure Vulkan doesn't default to the CPU (llvmpipe)
if ! grep -q "GALLIUM_DRIVER=d3d12" ~/.bashrc; then
  echo 'export GALLIUM_DRIVER=d3d12' >> ~/.bashrc
  echo 'export MESA_D3D12_DEFAULT_ADAPTER_NAME=NVIDIA' >> ~/.bashrc
fi

# 3. Reload environment
source ~/.bashrc

# 4. Verify the setup
echo "--- Checking OpenGL  ---"
glxinfo -B | grep -E "Device|Accelerated"

echo "--- Checking Vulkan  ---"
vulkaninfo | grep "Vulkan Instance Version"
vkcube

echo "run source ~/.bashrc to apply the changes, then you can run the virtual robots with GPU acceleration."

Check Vulkan

vulkaninfo | grep "Vulkan Instance Version"
vkcube

Run

run_vrobots.bash

#!/bin/bash
sudo chmod +x ./virtual_robots.x86_64
export LD_LIBRARY_PATH=$(echo "$LD_LIBRARY_PATH" | sed 's|:/opt/zenoh-c/lib||; s|/opt/zenoh-c/lib:||; s|/opt/zenoh-c/lib||')
nohup ./virtual_robots.x86_64 -force-vulkan > output.log 2>&1 &

🐍 Python Client (all platforms)

Install the Python IPC client:

pip install ubicoders-vrobots-ipc

with ROS2 system python:

sudo python3 -m pip install ubicoders-vrobots-ipc ubicoders-g2opy rerun-sdk==0.22.0  --break-system-packages
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

VRobots Book