Skip to main content
Pre-release

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.

  • LiberoHDF5Data reads a LIBERO demonstration HDF5 file (one task) as a UniEnv batch.
  • FromLiberoEnv runs 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's init_state attribute), or an index drawn from the seeded RNG. reset(seed=s) is reproducible.
  • terminated is task success (info["success"]); truncated after max_episode_steps (by default the suite's limit used by the OpenVLA / LeRobot evaluations: 220 / 280 / 300 / 520 / 400 steps).
  • settle_steps runs 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)

Source distribution for unienv-libero 0.0.1a1
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)

Table of built distributions (wheels) for unienv-libero 0.0.1a1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 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.

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