Rerun 开发环境搭建教程：从源码编译 Viewer 到跑通 Python SDK

Rerun 开发环境搭建教程从源码编译 Viewer 到跑通 Python SDK【免费下载链接】rerunVisualize, query, and stream to train on multimodal robotics data.项目地址: https://gitcode.com/GitHub_Trending/re/rerunRerun 是面向物理 AI 的多模态数据记录、查询与可视化工具能把图像、点云、时间序列等混合数据流实时渲染进同一个 Viewer。本文面向首次接触该仓库的开发者解决环境配不对、编译跑不通的问题按顺序执行即可从零搭建 Rerun 开发环境并跑通项目。读完后你会得到一个从源码编译的 Rerun Viewer、一个本地构建的 Python SDK、一个成功运行的最小日志示例以及一份可长期复用的排错速查表。项目速览Rerun 用 Rust 编写核心基于为多速率数据设计的列式分块存储附带 egui 界面 Viewer 与 Python、Rust、C 三套 SDK适合做机器人、计算机视觉、仿真方向调试的开发者。特性说明多模态记录图像、点云、张量、时间序列、视频统一入流按时间轴同步渲染可查询同一份数据可用 DataFrame 或 SQL 查询导出三语言 SDKPython、Rust、C日志端与可视化端解耦工程化整个仓库是 Rust workspace任务统一由 Pixi 脚本管理动手前的准备系统要求与依赖清单系统最低要求推荐要求LinuxUbuntu 22.04glibc 2.28GCC 9Ubuntu 24.04GCC 11macOSmacOS 11Intel 或 Apple SiliconmacOS 13Apple SiliconWindowsWindows 10VS 2022含 C 工作负载Windows 11VS 2022依赖清单仓库内 rust-toolchain 与 scripts/check_env.py 已锁定版本Rust 工具链 1.96.0含 cargo、rustcPixi 0.71.3用于环境安装与任务调度Git LFS仓库中的 UI 测试快照以 LFS 存储系统 C 编译器与链接器Linux 需 build-essentialWindows 由 VS 提供环境自检命令安装完成后执行一次pixi run check-env通过的标准对 pixi、cargo、rustc 三行分别打印... version ... is correct命令以退出码 0 结束若版本不符会打印Expected ... got ...并附上应执行的更新命令。安装与配置克隆仓库与工具链克隆仓库并进入根目录git clone https://gitcode.com/GitHub_Trending/re/rerun cd rerun安装 Rust 工具链先按官网指引装好 rustup再安装仓库锁定版本。Linux / Windowsrustup install 1.96.0macOSM 系列芯片需先指定主机架构rustup set default-host aarch64-apple-darwin # M1/M2 等 Apple Silicon rustup install 1.96.0安装 Git LFS 并拉取快照文件git lfs install git lfs pull预期输出git lfs ls-files能列出带.snap扩展名的文件说明 LFS 正常工作。安装并升级 Pixi 到仓库锁定版本按官网指引安装 pixi 后执行pixi self-update --version 0.71.3预期pixi --version输出 0.71.3。初始化项目环境在仓库根目录执行一次任意 pixi 任务如后文的pixi run check-env首次运行会自动安装 Python 等依赖并生成 Python 绑定所需的 PyO3 配置文件。预期输出上一节环境自检命令的全部is correct行。编译并启动构建并运行 Rerun Viewerpixi run rerun该任务等价于cargo run --package rerun-cli见 pixi.toml 的rerun定义首次编译为全量静态链接耗时较长属正常现象。产物位置调试版在target/debug/rerun需要 release 版时执行pixi run rerun-build-release产物在target/release/rerun。启动成功的标志屏幕弹出 Rerun 窗口显示示例蓝图树与空的时间轴在窗口外终端执行rerun --help能打印命令列表。需要浏览器内嵌版 Viewer 时可改用pixi run rerun-web。跑通最小示例Python 日志与 Viewer 同步先构建本地 Python SDKpixi run py-build # 基于 maturin 在 pixi 环境中开发安装 rerun-sdk然后用仓库自带的最小示例验证完整源码见 examples/python/minimal/minimal.pypixi run uv run examples/python/minimal/minimal.py核心逻辑只有这几行import numpy as np import rerun as rr # 本仓库的 Python SDK rr.init(rerun_example_minimal, spawnTrue) # 初始化并自动拉起一个 Viewer 子进程 positions np.vstack([xyz.ravel() for xyz in np.mgrid[3 * [slice(-10, 10, 10j)]]]).T colors np.vstack([rgb.ravel() for rgb in np.mgrid[3 * [slice(0, 255, 10j)]]]).astype(np.uint8).T rr.log(my_points, rr.Points3D(positions, colorscolors, radii0.5)) # 记录 3D 彩色点预期效果自动打开的 Viewer 中呈现一个 10×10×10 的点云立方体三个轴向分别呈红、绿、蓝渐变左侧面板的实体树中出现my_points。其余语言一句话带过Rust 同构示例执行cargo run -p minimal即可C 需先执行pixi run -e cpp cpp-build-all构建 SDK样例见 examples/cpp/minimal/。️ 排错速查表现象原因解决办法报failed to parse contents of PYO3_CONFIG_FILE在 pixi 之外直接跑 cargoPyO3 配置文件未生成执行pixi run ensure-pyo3-build-cfg后重试check-env提示 cargo 版本不符仓库锁定的 1.96.0 工具链未安装按提示执行rustup install 1.96.0M 系列 Mac 上rustc -vV的 host 是 x86_64默认主机架构未设为 ARM执行安装步骤第 2 条的rustup set default-host组合命令git lfs ls-files无输出或文件内容是指针文本Git LFS 未安装或未拉取重新执行安装步骤第 3 条的两条命令Windows 编译报符号链接symlink相关错误git 未启用 symlink 支持检查git config core.symlinks为 true 并开启 Windows 开发者模式无显卡环境窗口黑屏或起不来缺少 GPU 驱动或 WebGPU设置环境变量RERUN_ENABLE_SOFTWARE_RASTERIZER1参考 scripts/ci/setup_software_rasterizer.py收尾至此你已具备完整的 Rerun 本地开发闭环环境可自检、Viewer 可编译、Python SDK 可从源码安装、示例可端到端跑通。继续深入时从以下仓库内入口入手BUILD.md完整构建指南含各系统链接器优化配置CONTRIBUTING.md贡献流程与 PR 规范ARCHITECTURE.md仓库架构设计examples/Python / Rust / C 全语言示例集docs/snippets/INDEX.mdAPI 代码片段索引欢迎按 CONTRIBUTING.md 的指引提交你的第一个示例或修复下一篇将讲解如何把传感器数据接入 Rerun 并做 3D 可视化调试。【免费下载链接】rerunVisualize, query, and stream to train on multimodal robotics data.项目地址: https://gitcode.com/GitHub_Trending/re/rerun创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考