# ergoCub Humanoid Puzzle Manipulation: Teleoperation Logs of Unsolving and Solving a Puzzle (IIT AMI)

## Facts

- Provider: Artificial and Mechanical Intelligence (AMI) lab, Istituto Italiano di Tecnologia (curated by Giovanni Fregonese)
- License: CC-BY-4.0 (https://huggingface.co/datasets/ami-iit/puzzle_manipulation_datasets)
- Size: 24 files
- Format: Parquet (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/ami-iit/puzzle_manipulation_datasets
- Access: public, readable without an account
- Category: Robotics
- Source: https://www.science.org/doi/10.1126/scirobotics.adh3834
- Page: https://scigantic.com/archive/9ec938ce-a0ff-5b20-91c1-5e4d5292a8c3
- Keywords: Robotics, robot learning, Parquet, Hugging Face

## About

Logged teleoperation data from ergoCub, the humanoid robot of the Istituto Italiano di Tecnologia, manipulating a puzzle: in one experiment the robot first takes the puzzle apart (unsolve01) and then solves it (solve01). Data were collected by the AMI research line with the immersive avatar teleoperation stack developed for the ANA Avatar XPRIZE competition, described in the iCub3 avatar system paper (Science Robotics, 2023). Each folder holds Parquet tables of synchronized robot signals, including desired and measured joint states from the walking and manipulation controllers and timestamped RealSense RGB and depth image paths. 22 Parquet files, about 7.7 GB (measured 2026-11-21); read with pandas, pyarrow or Hugging Face datasets. The dataset was made to develop autonomous manipulation algorithms for ergoCub, such as imitation learning of bimanual humanoid manipulation from teleoperated demonstrations. It contains no personal data. Released under CC BY 4.0 by IIT; cite the iCub3 avatar system paper, Science Robotics, doi:10.1126/scirobotics.adh3834.

## Load the data

```python
from datasets import load_dataset
ds = load_dataset("ami-iit/puzzle_manipulation_datasets")
print(ds)
```

## Data structure

File types in sampled files: Parquet

Example file: `solve01/train-00000-of-00012.parquet`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/9ec938ce-a0ff-5b20-91c1-5e4d5292a8c3
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/9ec938ce-a0ff-5b20-91c1-5e4d5292a8c3
- Over MCP: `get_schema_card` with id `9ec938ce-a0ff-5b20-91c1-5e4d5292a8c3` at https://api.scigantic.com/mcp

## Related topics

- [Parquet datasets](https://scigantic.com/topics/parquet)
- [Robotics datasets](https://scigantic.com/topics/robotics)
- [Robot learning datasets](https://scigantic.com/topics/robot-learning)
