https://github.com/ioai-tech/lerobot-go
Go toolkit for LeRobot v2.1 and v3.0 datasets: write, validate, convert, and merge.
https://github.com/ioai-tech/lerobot-go
Last synced: 21 days ago
JSON representation
Go toolkit for LeRobot v2.1 and v3.0 datasets: write, validate, convert, and merge.
- Host: GitHub
- URL: https://github.com/ioai-tech/lerobot-go
- Owner: ioai-tech
- License: mit
- Created: 2026-06-05T08:56:14.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-15T14:30:38.000Z (26 days ago)
- Last Synced: 2026-06-15T16:23:45.833Z (26 days ago)
- Language: Go
- Size: 175 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# lerobot-go
[中文](README_zh.md) · Maintained by [IO-AI.TECH](https://io-ai.tech)
[](https://github.com/ioai-tech/lerobot-go/actions/workflows/ci.yml)
[](https://goreportcard.com/report/github.com/ioai-tech/lerobot-go)
[](LICENSE)
[](https://github.com/ioai-tech/lerobot-go/releases)
Go library and CLI for [LeRobot](https://github.com/huggingface/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
```bash
go install github.com/ioai-tech/lerobot-go/cmd/lerobot-go@latest
```
Pre-built binaries: [Releases](https://github.com/ioai-tech/lerobot-go/releases) (`linux` / `darwin` / `windows` × `amd64` / `arm64`, with `checksums.txt`).
## CLI
```bash
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](docs/CLI.md).
## Library
```go
import "github.com/ioai-tech/lerobot-go/lerobot"
```
Typical flow: `NewStagingWriter` per episode → `Merge` → `NewInspector().Validate`. See [docs/API.md](docs/API.md) and [examples/](examples/).
## Docs
- [CLI](docs/CLI.md) · [API](docs/API.md)
- [v2.1 layout](docs/protocol_v21.md) · [v3.0 layout](docs/protocol_v30.md)
- [Contributing](CONTRIBUTING.md) · [Changelog](CHANGELOG.md)
## Development
```bash
make test # unit tests
make lint # golangci-lint
make build # ./lerobot-go
```
## License
MIT — [LICENSE](LICENSE). Copyright (c) 2026 IO-AI.TECH.