README
¶
lerobot-go
中文 · Maintained by IO-AI.TECH
Go library and CLI for LeRobot datasets (v2.1 / v3.0): write, validate, convert, and merge. On-disk layout matches the official HuggingFace format.
Requirements: Go 1.26+; ffmpeg / ffprobe on PATH for video features.
Install
go install github.com/ioai-tech/lerobot-go/cmd/lerobot-go@latest
Pre-built binaries: Releases (linux / darwin / windows × amd64 / arm64, with checksums.txt).
CLI
lerobot-go validate ./dataset
lerobot-go convert -i ./v21 -o ./v30 --to v3.0
lerobot-go create -o ./dataset --version v3.0 --fps 30 --features ./features.json
lerobot-go merge -o ./merged --to v3.0 -i ./a -i ./b
| Command | Description |
|---|---|
validate |
Check v2.1 / v3.0 on-disk layout |
convert |
Convert between v2.1 and v3.0 |
create |
Finalize _staging/ep_* into a dataset |
merge |
Combine multiple datasets |
version / completion |
Version info and shell completion |
Global flags: -v, --ffmpeg-path, --json. Full reference: docs/CLI.md.
Library
import "github.com/ioai-tech/lerobot-go/lerobot"
Typical flow: NewStagingWriter per episode → Merge → NewInspector().Validate. See docs/API.md and examples/.
Docs
Development
make test # unit tests
make lint # golangci-lint
make build # ./lerobot-go
License
MIT — LICENSE. Copyright (c) 2026 IO-AI.TECH.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
lerobot-ds
command
|
|
|
lerobot-go
command
|
|
|
examples
|
|
|
validate_dataset
command
Validate an on-disk LeRobot dataset.
|
Validate an on-disk LeRobot dataset. |
|
write_v30
command
Write a minimal LeRobot v3.0 dataset via staging + merge.
|
Write a minimal LeRobot v3.0 dataset via staging + merge. |
|
internal
|
|
|
Package lerobot implements the HuggingFace LeRobot dataset writer and inspector for on-disk formats v2.1 and v3.0.
|
Package lerobot implements the HuggingFace LeRobot dataset writer and inspector for on-disk formats v2.1 and v3.0. |
Click to show internal directories.
Click to hide internal directories.