本页带你把一条录制从上传走到导出 LeRobot v3 数据集。全程基于同一个不可变数据集版本,导出的内容就是你复核过的内容。
1. 注册并创建项目
- 在控制台注册并创建团队。
- 打开「项目」,选择「新建项目」。填写项目名称,并选择录制类型:机器人(遥操作、机械臂、夹爪)或人类(第一视角人类示范)。
- 选择「创建」。录制、工作流、任务片段和数据集版本都归属于项目。
2. 上传录制
在控制台打开项目,进入「录制」,上传文件夹或文件。大文件直接传到对象存储,中断后可续传。
也可以在终端上传。先安装 CLI 并登录,命令是 embodiflow 或 ef。请显式传入 API 地址,因为默认值指向开发环境 API。
embodiflow auth login --base-url https://api.embodiflow.com
embodiflow whoami --json
embodiflow projects list --json然后把文件夹上传到项目,项目 ID 取自上面的列表。省略 --source-type 时,会按项目的录制类型自动推断。
embodiflow uploads create --project-id <project-id> --source-path ./recordings也可以用 team/project 引用创建一条命名录制:
embodiflow recordings upload ./recordings/rec-0001 --project <team>/<project> --name rec-0001传输中断后,加上 --resume 重新运行同一条命令即可。
3. 观察工作流运行
提交上传会启动项目工作流:标准化录制、运行质量检查,并按项目需要执行隐私和感知步骤。打开「工作流」下的「运行」查看每一步。不适用或已跳过的步骤会如实显示,不会显示为通过。
embodiflow workflow runs list --project-id <project-id>
embodiflow workflow runs wait <run-id>4. 复核任务片段
运行结束后打开「任务片段」。每个任务片段是从录制中切出的一次任务尝试。查看质量结果,在回放中打开片段,排除不应参与训练的片段。
5. 创建数据集版本
打开「版本」,选择「创建版本」。选择通过检查的任务片段、划分方式、标签和预处理。版本不可变:之后的改动会生成新的版本号,不会改写这个版本。
6. 导出并下载
在版本页导出 LeRobot v3,或用 CLI 一步下载。引用格式为 <team>/<project>@<版本号>。
embodiflow versions download <team>/<project>@1 --format lerobot-v3文件默认写入本地缓存 ~/.cache/embodiflow/datasets,可用 --dir 修改。如需分步控制:
embodiflow exports create --project-id <project-id> --version-number 1
embodiflow exports wait --project-id <project-id> --version-number 1 --export-id <export-id>
embodiflow exports download --project-id <project-id> --version-number 1 --export-id <export-id> --target-dir ./export下一步
- 命令行参考:每组命令附一个示例。
- REST API 与个人访问令牌,用于自动化。