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 RLBenchObservationConfig. 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 andinfo["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).terminatedis task success (info["success"]);truncatedaftermax_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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.