Inference
July 2, 2025 ยท View on GitHub
Inference Guide
Step 1: Download the test dataset
For the test data, we use the official RLBench2 dataset, which can be found here.
Step 2: Install xvfb(if running on server without display)
sudo apt install xvfb
sudo apt install qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools
Step 3: Modify Configuration Files
1. Update PPI/inference-for-rlbench2/conf/method/PPI.yaml
sam_checkpoint_path: the path to the SAM checkpoint
gdino_config_path: the path to the GroundingDINO config file in repo `GroundingDINO`
gdino_checkpoint_path: the path to the GroundingDINO checkpoint
instruction_embeddings_path: the path to the instruction embeddings
2. Update PPI/inference-for-rlbench2/conf/eval_ppi.yaml
framework.logdir: the path to the log directory(for saving the videos)
framework.weightsdir: the path to the weights directory
3. Modify the following variables in inference scripts in scripts/inference/:
framework.weight_name: the name of the weight
framework.ckpt_name: the name of the ckpt
rlbench.demo_path: the path to the test dataset
cinematic_recorder.save_path: the path to save the videos
4. Modify YOUR_PATH_TO_COPPELIASIM in the line 37 in PPI/inference-for-rlbench2/eval_ppi.py:
os.environ['QT_QPA_PLATFORM_PLUGIN_PATH'] = YOUR_PATH_TO_COPPELIASIM
Step 4: Run the inference script
First, start a virtual X server (Xvfb) on display :99 with a screen resolution of 1024x768 and 16-bit color depth, running in background.
Xvfb :99 -screen 0 1024x768x16 &
Then, run the inference script. The inference script is located in the scripts/inference directory. For example, to evaluate the ball task, run the following command:
bash scripts/inference/evaluate_ppi_ball.sh
Download checkpoints
Our checkpoints are available here.