# Record a dataset

Collect a small, consistent set of demonstrations after teleoperation passes.

Execution context: Controller computer; robot host must be prepared separately.

> Verification pending: existing website examples have not completed a pinned-source or physical-hardware walkthrough. Confirm software version, hardware revision, and actual stopping procedure. Do not assume emergency-stop or release-to-stop behavior. Explicit human approval and supervision are required before physical movement.

## Before you record

Start with five short episodes so mistakes are inexpensive to correct. Keep the task wording, camera placement, starting area, and success condition consistent.

## Record a dataset

Replace the IP, ports, dataset ID, and task before running this on the controller.

```shell
uv run lerobot-record --robot.type=sourccey_client --robot.id=sourccey --robot.remote_ip=192.168.1.243 --teleop.type=bi_sourccey_leader --teleop.id=sourccey_leader --teleop.left_arm_port=COM5 --teleop.right_arm_port=COM6 --teleop_keyboard.type=keyboard --teleop_keyboard.id=sourccey_keyboard --dataset.repo_id=vulcan-studio/sourccey-demo-1 --dataset.num_episodes=5 --dataset.episode_time_s=60 --dataset.reset_time_s=15 --dataset.single_task="Fold the shirt" --dataset.fps=30 --dataset.push_to_hub=false --display_data=true
```

Keep push_to_hub=false for local data. Enable it when you intend to upload and are signed into the correct Hugging Face account.

## Recording controls

| Key | Action |
| --- | --- |
| Right Arrow | Save the current episode |
| Left Arrow | Discard and re-record |
| Escape | Stop recording |

## Dataset check

- All five episodes save successfully.
- No camera freezes or timing errors occur.
- Every saved episode completes the task.
- Control is uninterrupted throughout each episode.

Website: https://vulcanrobotics.ai/docs/lerobot/record

Upstream reference (unpinned): https://github.com/vulcan-forge/lerobot-vulcan/blob/main/docs/sourccey/03-record.md