Skip to main content

leCop: a robot cop with sunglasses

leCop

The police of your robot dataset.

CI codecov license: MIT OR Apache-2.0 Rust

Find the broken episodes in your LeRobot dataset in milliseconds, before they cost you a training run.

lecop validating a dataset: it lists a video with the wrong number of frames and an idle episode

Quick start

cargo install lecop      # or: uvx lecop path/to/dataset
lecop path/to/dataset

That is all: no Python, no config, no dataset download. Exit code 0 means clean, 1 means errors, so it also works as a CI step.

What it catches

  • A video with 591 frames for an episode of 588.
  • Timestamps that drift, or frames that went missing.
  • Totals in info.json that disagree with the data (and --fix repairs them).
  • A robot that sat idle for most of an episode, or whose action froze for seconds.
  • Statistics that do not match the data, constant or clipped signals, NaNs.
  • Missing, truncated or unreadable files.
  • With --decode: a camera that froze or went black.

58 checks in all, listed in docs/checks.md.

Why leCop

  • Fast. 8 to 28 ms per dataset without video decoding, 15x to 54x faster than lerobot-doctor on the same checks. Video is checked from the container, not by decoding frames, unless you ask for --decode.
  • Nothing to set up. One binary. LeRobot v2.x and v3.x.
  • Made for CI. Stable issue codes, --format json and GitHub annotations, a config file to ignore or re-grade findings.

Compared with lerobot-doctor and physlint, check by check, in docs/comparison.md.

More

Unofficial. Not affiliated with Hugging Face or the LeRobot project. Early stage: tested on synthetic fixtures and on 16 real Hub datasets (v2.1 and v3.0), one of them with real faults; no real v2.0 dataset yet.

Contributing

cargo test
cargo bench   # criterion; see .claude/rules/performance.md

scripts/fetch-datasets.sh          # list real test datasets that are missing
scripts/fetch-datasets.sh --yes    # download them into datasets/ (git-ignored)

cargo test also checks the error and warning counts on every downloaded dataset listed in scripts/datasets.tsv and skips the ones you do not have.

See CONTRIBUTING.md and STYLE_GUIDE.md.

License

Licensed under either of Apache License 2.0 or MIT license at your option.

Metadata

Release files for lecop 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lecop 0.1.0
File Size Uploaded Provenance Actions
lecop-0.1.0.tar.gz 378.2 kB Without provenance Details for lecop-0.1.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for lecop 0.1.0
File Actions
lecop-0.1.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for lecop-0.1.0-py3-none-win_amd64.whl
lecop-0.1.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for lecop-0.1.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
lecop-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for lecop-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
lecop-0.1.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for lecop-0.1.0-py3-none-macosx_11_0_arm64.whl
lecop-0.1.0-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for lecop-0.1.0-py3-none-macosx_10_12_x86_64.whl

Total release size: 20.5 MB

Release files / lecop-0.1.0.tar.gz

Download URL lecop-0.1.0.tar.gz
Size 378.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b11015eb427b6fc2c0d5aee7f074549e708988e8b46baf34ef6fb8cf441a6eee
BLAKE2b-256 checksum
How to use checksums
4238b76cd1e94691f35c6c3bade794d27735c0c199480aeb0f1f8e7eeec2470d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / lecop-0.1.0-py3-none-win_amd64.whl

Download URL lecop-0.1.0-py3-none-win_amd64.whl
Size 4.0 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
7f7728af0485164252be2a0da660b4a4f1c7a3d1b9243fa63c4ab54c7572db86
BLAKE2b-256 checksum
How to use checksums
d0da00850cc38431de18c330b0ab44b5433a56a71b8f6679a5c3dedae45706e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / lecop-0.1.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL lecop-0.1.0-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 4.2 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
ba1d435a56880496b222195383e8081b0b066f1b9be0fe9f2dfa176b3709e0d9
BLAKE2b-256 checksum
How to use checksums
6fd84f6e5746d569a50f9539ded81a870199ad59fec1afd4937a7206815d7990
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / lecop-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL lecop-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 4.0 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
ecbbafc9b4363a518423306aea567c45d0b93f2eafe5a83cc490e911702c52c7
BLAKE2b-256 checksum
How to use checksums
6a01f8bb4dd3ada74e5ee0a30616bfd9e37c23af2180ca08b4686bde931a63c6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / lecop-0.1.0-py3-none-macosx_11_0_arm64.whl

Download URL lecop-0.1.0-py3-none-macosx_11_0_arm64.whl
Size 3.8 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
8a0fbd876f15c3d703b4b6d78ca369644f7aa982f9e9c4e6c02526b36ef8079e
BLAKE2b-256 checksum
How to use checksums
a742d0a7c453ed6006fad77d47bd88d32a8579506a3dfbd1d1e9ef1b0d6e6bee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / lecop-0.1.0-py3-none-macosx_10_12_x86_64.whl

Download URL lecop-0.1.0-py3-none-macosx_10_12_x86_64.whl
Size 4.0 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
7f2b077947b38ab985fff1e07ee23df4e288b96961c287a3b63dd2064001cddd
BLAKE2b-256 checksum
How to use checksums
79a19d1855688e8a1530daf383138c47827383a69390383282aee0473d358d35
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for lecop 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page