Skip to documentation
Developer guides

Record a dataset

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

01

Before you record

Check that this guide matches your robot and software. Before moving the robot, clear its workspace, stay nearby, and confirm the stopping procedure for your unit with the team. Stop controls and what happens when you release the controls can vary; closing a terminal does not replace a physical emergency stop.

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

02

Record a dataset

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

Controller computer · terminal
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.

03

Recording controls

Keyboard controls
KeyAction
Right ArrowSave the current episode
Left ArrowDiscard and re-record
EscapeStop recording
04

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.

About these examples: checks against a specific software version and a full hands-on walkthrough are still in progress. The source documentation below can help you and the team confirm the right instructions for your setup.

View upstream documentation·Read as Markdown
Vulcan Robotics / SourcceyBuild. Learn. Iterate.