---
warning: DO NOT CHANGE THIS MANUALLY, THIS IS GENERATED BY https://github.com/duckdb/community-extensions repository, check README there
title: lerobot
excerpt: |
  DuckDB Community Extensions
  Query and create LeRobot v3 datasets, including frame data, images, and video observation windows.

extension:
  name: lerobot
  description: Query and create LeRobot v3 datasets, including frame data, images, and video observation windows.
  version: 0.1.0
  language: C++
  build: cmake
  license: Apache-2.0
  maintainers:
    - kaka11chen
  excluded_platforms: "wasm_mvp;wasm_eh;wasm_threads"
  requires_toolchains: "multimedia"
  vcpkg_commit: "84bab45d415d22042bd0b9081aea57f362da3f35"
  test_config: '{"test_env_variables":{"LEROBOT_NON_GPL_FFMPEG_TESTS":"1"}}'

repo:
  github: AstroVela/duckdb-lerobot
  ref: 901f26a6639c3f3ba763a4df758d83e197694806

docs:
  hello_world: |
    LOAD lerobot;

    COPY (
      SELECT 0::BIGINT AS episode_index,
             'pick up a block' AS task,
             i::FLOAT AS action
      FROM range(10) AS frames(i)
      ORDER BY i
    ) TO 'lerobot_example' (
      FORMAT lerobot,
      FPS 10,
      FEATURES '{"action": {"dtype": "float32", "shape": [1]}}'
    );

    SELECT episode_index, frame_index, timestamp, action
    FROM lerobot_scan('lerobot_example')
    ORDER BY frame_index;

  extended_description: |
    Read LeRobot v3 metadata and frame data, create datasets with COPY, decode
    RGB video frames, and select temporal observation windows with SQL.
    TorchCodec integration is available through a separate optional Python package.

    The extension source is Apache-2.0. Native binaries statically link LGPL FFmpeg,
    libaom, dav1d, and zlib with their respective licenses. GPL codecs are excluded
    from the default build. Corresponding source and rebuilding instructions are
    described in [REDISTRIBUTION.md](https://github.com/AstroVela/duckdb-lerobot/blob/v1.5-variegata/REDISTRIBUTION.md).

extension_star_count: 2
extension_star_count_pretty: 2
extension_download_count: 823
extension_download_count_pretty: 823
image: '/images/community_extensions/social_preview/preview_community_extension_lerobot.png'
layout: community_extension_doc
---
### Compatibility Matrix

This table covers all DuckDB releases that have not reached [end-of-life](https://duckdb.org/release_calendar), including LTS releases, and shows the 2 most recent patch releases of each. Older patch releases are not listed, but the extension may be available for them as well.

<div class="extension_compatibility_table"></div>

| Platform | 1.4.4 | 1.4.5 | 1.5.5 | 1.5.6 | 2.0.0 |
| :--- | :---: | :---: | :---: | :---: | :---: |
| Linux AMD64 | ❌ | ❌ | ✅ | ✅ | ❌ |
| Linux ARM64 | ❌ | ❌ | ✅ | ✅ | ❌ |
| macOS AMD64 | ❌ | ❌ | ✅ | ✅ | ❌ |
| macOS ARM64 | ❌ | ❌ | ✅ | ✅ | ❌ |
| Windows AMD64 | ❌ | ❌ | ✅ | ✅ | ❌ |
| Windows ARM64 | ❌ | ❌ | ❌ | ❌ | ❌ |
| WebAssembly | ❌ | ❌ | ❌ | ❌ | ❌ |

### Installing and Loading
```sql
INSTALL {{ page.extension.name }} FROM community;
LOAD {{ page.extension.name }};
```

{% if page.docs.hello_world %}
### Example
```sql
{{ page.docs.hello_world }}```
{% endif %}

{% if page.docs.extended_description %}
### About {{ page.extension.name }}
{{ page.docs.extended_description }}
{% endif %}
### Added Functions

<div class="extension_functions_table"></div>

|      function_name       | function_type | description | comment | examples |
|--------------------------|---------------|-------------|---------|----------|
| lerobot_cache_info       | table         | NULL        | NULL    |          |
| lerobot_decode_image     | scalar        | NULL        | NULL    |          |
| lerobot_episodes         | table         | NULL        | NULL    |          |
| lerobot_info             | table         | NULL        | NULL    |          |
| lerobot_scan             | table         | NULL        | NULL    |          |
| lerobot_stats            | table         | NULL        | NULL    |          |
| lerobot_tasks            | table         | NULL        | NULL    |          |
| lerobot_temporal_targets | table         | NULL        | NULL    |          |
| lerobot_video_frames     | table         | NULL        | NULL    |          |
| lerobot_video_routes     | table         | NULL        | NULL    |          |
| lerobot_video_targets    | table         | NULL        | NULL    |          |
| lerobot_video_windows    | table         | NULL        | NULL    |          |

### Overloaded Functions

<div class="extension_functions_table"></div>

This extension does not add any function overloads.

### Added Types

<div class="extension_types_table"></div>

This extension does not add any types.

### Added Settings

<div class="extension_settings_table"></div>

This extension does not add any settings.