HFlow icon

HFlow

HFlow 是一款开源 SDK,用于为机器人和物理 AI 构建多模态数据质量、处理、增强与整理流水线。帮助团队将录制回放转为经过质量检查、可查询且具溯源和目录支持的数据集。

HFlow

概述

HFlow 是一款开源 SDK,用于为机器人和物理 AI 构建多模态数据质量、处理、增强与整理流水线。文档将其描述为面向生产的数据工具,可将已落地的录制转化为规范化、经过质量检查且可查询的数据集。

该项目聚焦于机器人领域的一个常见数据问题:录制内容可能包含来自多个系统的视频、状态、动作、时间戳和元数据,但团队需要一种可靠方式来验证质量、运行转换、追踪溯源并整理清单。HFlow 围绕标准 MCAP episode 提供这一完整生命周期,使用基于 Python 的处理步骤、目录支持的证据以及通过 DuckDB SQL 进行的整理。

功能

基于 MCAP 的多模态流水线

处理可组合的视频、状态、动作、时间戳和来自多个录制系统的元数据等多模态 episode,并以 MCAP 作为 v1 输入和输出边界。

可扩展的处理步骤

运行内置检查,或添加你自己的 Python 转换、检查、标签和增强,同时将现有处理代码保留在你自己的环境中。

溯源与版本跟踪

通过溯源数据、架构和工具版本、可用时的源 URI,以及与步骤版本绑定的目录记录,追踪每个输出是如何生成的。

可视化编排

通过 Airflow DAG 将工作流渲染为图形,以便团队在计划执行期间查看任务状态、日志、重试和重新运行。

可查询的目录与整理

将元数据、质量证据、标签、版本标记和工件位置存储在 Parquet 目录中,以便使用 DuckDB 回答语料库级问题,而无需打开每条录制。

灵活的部署模式

同时支持使用 Docker Compose 的本地单租户工作区,以及部署到现有的 Airflow 3 环境,并将数据平面与控制平面关注点分离。

使用场景

  • 录制 episode 的数据质量控制

    在数据下游流转之前,通过检查冻结摄像头、漂移流、缺失主题或重复 episode 等问题来验证已落地的机器人录制。

  • 迁移并规范化现有处理代码

    通过添加转换、检查、标签和增强,将现有脚本转换为更可审计的流水线,同时保留底层 Python 代码和步骤逻辑的熟悉感。

  • 语料库整理与清单创建

    通过查询目录、检查质量证据并编写版本固定的输出,为训练或分析创建经过整理的数据集清单,而无需加载每个 MCAP 文件。

  • 从本地到计划任务的流水线执行

    在开发期间本地运行同一流水线,然后在 Airflow 3 环境中对其进行调度,以便周期性运行和监控。

  • 数据集审计与故障排查

    通过沿着流水线图和目录记录追踪溯源、步骤版本和工件位置,调查结果是如何生成的。

Pros and Cons

Pros

  • 专为多模态机器人数据而构建,包括视频、状态、动作、时间戳和元数据。
  • 处理代码保持在 Python 中,并允许现有代码通过小型适配器接入,而无需重写。
  • 记录溯源、架构、工具版本和目录元数据,帮助审计和复现数据集。
  • 通过生成的 Airflow 3 DAG 同时支持本地开发和计划执行。
  • 让团队无需加载录制本身即可使用 DuckDB 查询语料库级元数据和质量证据。

Cons

  • 代码仓库处于 pre-v1 阶段,因此在评估是否采用时,实施状态和剩余工作量仍然很重要。
  • 开源仓库不包含托管控制平面;文本说明对托管平台存在兴趣,但这里尚未实现,也不是 pre-v1 承诺。
  • 这里提供的源码文本未包含完整的集成列表或详细的连接器覆盖范围。

FAQ

HFlow 是做什么的?

HFlow 是一款开源 SDK,用于为机器人和物理 AI 构建多模态数据质量、处理、增强与整理流水线。它面向处理机器人或传感器录制数据并需要以结构化方式将其转化为整理后数据集的团队。

HFlow 已经适合生产环境了吗?

该仓库将 HFlow 描述为 pre-v1,核心生命周期已可端到端运行。它可在本地试用,项目也提示读者查看实现状态和开放问题以获取最新详情。

HFlow 会处理和产出什么?

HFlow 从每个受支持的标准 MCAP 文件中的一个多模态 episode 开始。它可以运行转换、质量检查、标签和增强,然后写出规范化的 MCAP 输出、溯源信息、工件以及用于整理的 Parquet 目录。

HFlow 如何运行?

开源部署可以作为单租户工作区,通过随附的 Docker Compose 运行时运行,也可以在你已管理的 Airflow 环境中,以生成的 Airflow 3 DAG 形式运行。仓库还提到提供本地快速开始和打包的快速开始。

HFlow 支持哪些集成?

源码文本中未在提取的页面内容里列出固定的集成目录。不过它确实提到了 Python 转换、Airflow 3 DAG 生成、用于整理的 DuckDB SQL、MCAP 格式,以及与 Foxglove 和 Rerun 等工具打开 MCAP 数据的兼容性。

Quick Facts

类别
开发者工具
领域
github.com
平台
开源 GitHub 仓库
主要用户
机器人和物理 AI 团队
运行时
带有 Airflow 3 DAG 生成的 Python SDK
数据格式
MCAP episodes