rerun-io/rerun
数据开源 SDK 与查看器,用于记录、可视化和查询机器人及传感器多模态时序数据。
项目介绍
Rerun 是面向物理 AI 和机器人领域的数据层与可视化工具。它能接收多速率、多模态的数据,包括图像、点云、变换、时间序列、关节状态和视频,来源涵盖机器人日志、仿真、人体数据采集设备,以及 MCAP、rrd、LeRobot 等格式。内置查看器会把这些数据流同步渲染,可以拖动时间轴回放片段、并排对比传感器,并实时观察计算机视觉管线运行。同一份录制数据可以通过 dataframe 或 SQL 查询,也能直接流式送入训练。SDK 覆盖 Python、Rust 和 C++,核心用 Rust 编写 项目定位与适用对象。
典型用户是需要时序调试手段的机器人、仿真和计算机视觉工程师。例如机器人行为异常时,Rerun 可以把摄像头画面、深度图、激光扫描、分割结果、3D 地图和检测结果放在同一条时间线上查看 示例场景。它不限于机器人:任何包含传感器或随时间变化的 2D/3D 状态的项目都可以使用。
快速使用
Python 路径最短,因为 Python SDK 自带查看器:
- 安装 SDK:
pip install rerun-sdk。Conda 用户可使用 rerun-sdk feedstock;Rust 用户可执行cargo add rerun。 - 记录一段简单数据:
import rerun as rr
rr.init("rerun_example_app")
rr.spawn() # 启动查看器并连接
rr.set_time("frame", sequence=42)
rr.log("path/to/points", rr.Points3D(positions, colors=colors))
- 在启动的查看器中检查记录的点云。使用
rr.save("recording.rrd")写入磁盘,或用rr.connect_grpc()连接远程查看器 示例。
C++ 和 Rust 不自带查看器,需要单独安装 rerun 二进制。可以执行 pip install rerun-sdk,或执行 cargo install rerun-cli --locked --features nasm;nasm 特性要求 PATH 中有 nasm CLI,跳过该特性会降低视频解码性能 查看器安装。安装后 rerun --help 应能正常运行。可从 Python、C++ 或 Rust 入门指南开始;浏览器查看器 无需本地安装即可打开录制文件。
使用约束
Rerun 仍在活跃开发,API 会继续演进,应预期破坏性变更。文档列出的已知限制包括:实体过多时查看器会变慢,数百万点的点云也可能较慢 状态与不足。在长时间运行或内存受限的应用中,查看器的内存缓冲可以调小,包括把它当作 RViz 替代品时 限制内存。项目支持 MCAP 摄取和 LeRobot 风格数据,使用其他第三方格式时应先查阅摄取文档。
核心代码以 MIT 和 Apache-2.0 开源。Rerun Hub 是面向机器人数据的可扩展编目产品,属于独立商业服务,目前仅对部分设计合作伙伴开放;仓库本身保持免费开源 商业模式。
HotRepo 点评
Rerun 在 2026-11-06 的 Rust 日榜上位列第 12,当天新增 14 star。这只是单次快照,不能说明趋势,但结合 11.7k star 可以看出它仍在 Rust 生态中保持可见度。项目在 Hacker News 上有多条发布记录,覆盖 0.25 到 0.30 版本,但提供的讨论仅有少量票数和评论。0.30 版本讨论中有一条评论指出,任意标量数据已能直接绘图,包括浮点、整数、无符号整数、布尔和嵌套 Arrow 数据,无需预定义语义;自定义可视化器也可注册进现有 2D/3D/Map 视图并使用自定义着色器 0.30 讨论。这些是发布说明层面的说法,不是对质量的独立评估。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。