Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

unienv-rlbench

RLBench tasks as UniEnv environments, with UniEnv space metadata.

from rlbench.action_modes.action_mode import JointPositionActionMode
from rlbench.tasks import ReachTarget
from unienv_rlbench import FromRLBenchEnv

env = FromRLBenchEnv.create(ReachTarget, obs_config="vision", action_mode=JointPositionActionMode(),
                            max_episode_steps=200)
instruction, obs, info = env.reset(seed=0)        # context: the episode's language instruction
obs, reward, terminated, truncated, info = env.step(env.sample_action())
env.close()
  • obs_config: "state" (low-dimensional), "vision" (all cameras: RGB, depth, point clouds, masks) or an RLBench ObservationConfig. The observation space is inferred from a first observation and described with space metadata (unienv_rlbench.space_metadata): image formats, depth in meters or normalized between the clipping planes, world-frame point clouds, joint states, gripper_pose (quaternion xyzw), camera intrinsics / extrinsics. The action space records the arm / gripper action mode.
  • The context is the episode's language instruction; info["descriptions"] has all of RLBench's descriptions and info["variation"] the task variation.
  • variation: a fixed task variation (default 0) or "random" to sample one at each reset.
  • reset(seed=s) reproduces the episode (object placement, variation, instruction); the robot's proprioception can still differ slightly between resets (CoppeliaSim keeps some dynamics state).
  • terminated is task success (info["success"]); truncated after max_episode_steps.
  • reset(target_demo=demo) starts from a demonstration; get_live_demos(n) records demonstrations.
  • render() returns an RGB frame from a 640x360 camera (render_mode="rgb_array").

unienv_rlbench.space_metadata (and import unienv_rlbench) work without RLBench.

Installation

RLBench, PyRep and CoppeliaSim are not on PyPI, so they are installed separately (Python 3.10 works):

pip install unienv_rlbench

# CoppeliaSim 4.1.0 (Ubuntu 20.04 build; also runs on Ubuntu 22.04 / 24.04)
wget https://downloads.coppeliarobotics.com/V4_1_0/CoppeliaSim_Edu_V4_1_0_Ubuntu20_04.tar.xz
tar -xf CoppeliaSim_Edu_V4_1_0_Ubuntu20_04.tar.xz
export COPPELIASIM_ROOT=$PWD/CoppeliaSim_Edu_V4_1_0_Ubuntu20_04
export LD_LIBRARY_PATH=$COPPELIASIM_ROOT QT_QPA_PLATFORM_PLUGIN_PATH=$COPPELIASIM_ROOT

# PyRep (its pinned cffi 1.14.2 has no wheels for Python >= 3.10: install a current cffi first)
pip install cffi numpy
git clone https://github.com/stepjam/PyRep && pip install --no-build-isolation ./PyRep

# RLBench (it imports gymnasium without declaring it)
pip install git+https://github.com/stepjam/RLBench.git gymnasium

Headless machines need an X server for the cameras, e.g. xvfb-run -a python script.py.

Tests

pytest tests runs the metadata tests anywhere; with RLBench installed the simulator tests run too (xvfb-run -a pytest tests on a headless machine; the vision configurations render on the CPU there and take a few minutes each).

License

Apache-2.0. RLBench, PyRep and CoppeliaSim are installed separately and keep their own licenses (CoppeliaSim Edu is free for educational use).

Metadata

Release files for unienv-rlbench 0.0.1a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for unienv-rlbench 0.0.1a1
File Size Uploaded Provenance Actions
unienv_rlbench-0.0.1a1.tar.gz 18.4 kB With provenance Details for unienv_rlbench-0.0.1a1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for unienv-rlbench 0.0.1a1
File Interpreter ABI Platform Actions
unienv_rlbench-0.0.1a1-py3-none-any.whl Python 3 none any Details for unienv_rlbench-0.0.1a1-py3-none-any.whl

Total release size: 33.6 kB

Release files / unienv_rlbench-0.0.1a1.tar.gz

Download URL unienv_rlbench-0.0.1a1.tar.gz
Size 18.4 kB
Tags Source
SHA-256 checksum
How to use checksums
dc8de8a5d2f0b947222c5074535f80030b6b93a5e35fa08b850e511610847558
BLAKE2b-256 checksum
How to use checksums
c90dbba09a2028a31b7f1df2bd7d04936b671cf41fcc29380508a7abfe1f917f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / unienv_rlbench-0.0.1a1-py3-none-any.whl

Download URL unienv_rlbench-0.0.1a1-py3-none-any.whl
Size 15.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3e161ddeb04de333ce175b27e0418ccd59ab81caea966c72d9a807fb386e87b7
BLAKE2b-256 checksum
How to use checksums
0c05a21bccf0ec5e7b1486e1a2c2e229f8b9d301193e499c15cea12613090001
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for unienv-rlbench 0.0.1a1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for unienv_rlbench-0.0.1a1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page