This release is a pre-release and may not be stable for production use.
unienv-libero
LIBERO for UniEnv: the demonstration datasets and the simulated tasks, with one observation layout.
LiberoHDF5Datareads a LIBERO demonstration HDF5 file (one task) as a UniEnv batch.FromLiberoEnvruns a task of a LIBERO suite as a UniEnv environment whose observations use the dataset's keys, dtypes, image convention and space metadata, so a policy trained on the data runs in the environment unchanged.
pip install unienv_libero # datasets
pip install "unienv_libero[env]" # + the simulated tasks (LIBERO, robosuite 1.4, MuJoCo < 3.10)
Environment
from unienv_libero import FromLiberoEnv
env = FromLiberoEnv("libero_spatial", task_id=0, settle_steps=10)
instruction, obs, info = env.reset(seed=0) # context: the task's language instruction
obs, reward, terminated, truncated, info = env.step(env.sample_action())
- Suites:
libero_spatial,libero_object,libero_goal,libero_10,libero_90. - Episodes start from the benchmark's fixed initial states:
reset(init_state_id=i),reset(init_state=...)(any flattened MuJoCo state, e.g. a demonstration'sinit_stateattribute), or an index drawn from the seeded RNG.reset(seed=s)is reproducible. terminatedis task success (info["success"]);truncatedaftermax_episode_steps(by default the suite's limit used by the OpenVLA / LeRobot evaluations: 220 / 280 / 300 / 520 / 400 steps).settle_stepsruns no-op steps after each reset so objects settle (those evaluations use 10).- Actions are LIBERO's normalized OSC_POSE deltas in [-1, 1]^7 (gripper -1 open, 1 close).
render()returns the upright agentview image.
Observations (image_size=128 and no depth by default, as in the datasets):
| Key | From robosuite | |
|---|---|---|
agentview_rgb, eye_in_hand_rgb |
uint8 (H, W, 3) | agentview_image, robot0_eye_in_hand_image |
ee_pos, ee_ori, ee_states |
float64 (3,), (3,), (6,) | robot0_eef_pos, axis-angle of robot0_eef_quat |
gripper_states, joint_states |
float64 (2,), (7,) | robot0_gripper_qpos, robot0_joint_pos |
{agentview,eye_in_hand}_depth (use_depth=True) |
float32 (H, W, 1) | *_depth |
Images keep robosuite's "opengl" convention, like the datasets: they are upside down, which the space
metadata records (flipped="vertical").
On first use LIBERO downloads its scene assets from the Hugging Face Hub (~/.cache/libero/assets).
FromLiberoEnv writes LIBERO's default ~/.libero/config.yaml (or $LIBERO_CONFIG_PATH) if it is missing,
so importing LIBERO does not stop to ask for a dataset folder. Headless rendering uses EGL: set
MUJOCO_GL=egl.
Installing LIBERO builds egl_probe, which needs CMake; with CMake 4 set
CMAKE_POLICY_VERSION_MINIMUM=3.5 for the build.
Datasets
from unienv_libero import LiberoHDF5Data
data = LiberoHDF5Data("libero_spatial/pick_up_the_black_bowl_between_the_plate_and_the_ramekin_and_place_it_on_the_plate_demo.hdf5")
batch, metadata = data.get_at_with_metadata([0, 1, 2]) # metadata: episode_id, step_i
data.language_instruction
The space is inferred from the file and annotated with UniEnv space metadata (libero_space_metadata),
following LIBERO's scripts/create_dataset.py layout: cameras, end-effector / joint / gripper states and
actions as normalized OSC_POSE deltas. FromLiberoEnv(...).demo_file_name names a task's file in the
LIBERO datasets (e.g. the yifengzhu-hf/LIBERO-datasets dataset on the Hugging Face Hub).
Tests
pytest tests runs without LIBERO. With unienv_libero[env] installed the simulator tests run too; set
LIBERO_DEMO_FILE to the libero_spatial task 0 demonstration file to also replay recorded demonstrations.
License
Apache-2.0. LIBERO (MIT), robosuite and MuJoCo are installed separately and keep their own licenses.
Metadata
Release files for unienv-libero 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_libero-0.0.1a1.tar.gz | 20.0 kB | With provenance | Details for unienv_libero-0.0.1a1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| unienv_libero-0.0.1a1-py3-none-any.whl | Python 3 | none | any | Details for unienv_libero-0.0.1a1-py3-none-any.whl |
Total release size: 36.8 kB
Release files / unienv_libero-0.0.1a1.tar.gz
| Download URL | unienv_libero-0.0.1a1.tar.gz |
|---|---|
| Size | 20.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7e3102092c8b803de07187ae1aeab765f8af2be5d9d7b7009e752322e0f59dc1
|
|
BLAKE2b-256 checksum How to use checksums |
d9859540e069e788f3c313f63c73f6d8fec8d4e5d7554949720dd2c0c637efa6
|
| 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_libero-0.0.1a1-py3-none-any.whl
| Download URL | unienv_libero-0.0.1a1-py3-none-any.whl |
|---|---|
| Size | 16.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8347a3a7e6314838d05e0986d4989281e1639334c9e1027ebfdf1bf7c60413ab
|
|
BLAKE2b-256 checksum How to use checksums |
a25a1578dd76399e9cf12c0597318a36dc0c10fd1a5176f5520e22dfd45f59f4
|
| 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-libero 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_libero-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.