Rerun 开发环境 30 分钟从零到跑通Viewer 编译 Python 示例 多语言 SDK【免费下载链接】rerunVisualize, query, and stream to train on multimodal robotics data.项目地址: https://gitcode.com/GitHub_Trending/re/rerun你刚 clone 完 Rerun 仓库目标只有一个30 分钟内把这套 Rerun 开发环境完全跑通——从源码编译启动 Rerun Viewer再跑一个 Python 最小示例让一屏 3D 点云出现在窗口里。前置条件不苛刻Git带 LFS、rustup 管理的 Rust 工具链、pixi 环境管理器只有要碰 C SDK 时才需要额外装 CMake。下面的顺序是先跑通最小闭环再按需扩展每走一步都能确认一个可见的结果。一份工具清单覆盖三端Rerun 安装教程的公共依赖三个系统的核心工具完全相同只有基础安装命令有差异先对照这张总表工具要求版本用途安装方式Git Git LFS最新稳定版克隆仓库、拉取测试资产各平台包管理器 / 官网安装包Rust 工具链1.88.0编译 Viewer 与 Rust SDKrustup install 1.88.0 rustup default 1.88.0Pixi0.41.4统一执行构建 / 测试 / 格式化任务curl -fsSL https://pixi.sh/install.sh \| bash再pixi self-update --version 0.41.4CMake最新稳定版仅 C SDK 编译需要各平台包管理器系统底线Linux 建议 Ubuntu 22.04 GCC 11macOS 13 / Xcode 14Windows 11 / VS 202220.04 / macOS 11 / Win10 是能跑的最低配置。rustup 与 pixi 的安装在三端流程一致Linux 和 macOS 用这一条就够curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y source $HOME/.cargo/env真正有差异的只有这几处Linux先sudo apt update sudo apt install -y build-essential git git-lfs补齐编译器和 LFS。macOSbrew install git git-lfs即可Apple Silicon 用户记得rustup set default-host aarch64-apple-darwin后再装工具链。WindowsGit 安装时勾选 Enable symbolic links装完执行git lfs installrustup 走官网的 rustup-init.exe 默认安装确认 VS 2022 和 Windows SDK 装好编译统一在 VS 提供的命令提示符里跑能省掉大量莫名其妙的链接错误。先跑通最小闭环克隆仓库到 3D 点云渲染克隆仓库并初始化 Git LFS仓库里有大量测试资产走 LFS 通道不 pull 全的话后续示例会缺文件git clone https://gitcode.com/GitHub_Trending/re/rerun.git cd rerun git lfs install git lfs pull进仓库后先跑一次环境体检它会核对所有依赖版本是否符合要求pixi run check-env⚠️ 如果后续编译报linker cc not foundLinux 下基本就是缺sudo apt install build-essential。编译并启动 Rerun Viewerpixi run rerun等价于在 pixi.toml 里定义的那条cargo run --package rerun-clirelease_no_web_viewer 特性首次是全量编译 Rerun 源码确实要等一会儿建议先去倒杯水pixi run rerun # 调试模式编译最快 pixi run rerun --release # 发布模式运行性能最好窗口起来就说明 Viewer 编译这条链路通了。⚠️ 两个常见翻车点报fatal error: EGL/egl.h file not found是缺图形库Linux 执行sudo apt install libegl1-mesa-dev libgl1-mesa-dev libglu1-mesa-devmacOS 执行brew install mesaWindows 上链接错误多半是没在 VS 命令提示符里编译或 VS 2022 / Windows SDK 没装全。本地编译并安装 Rerun Python SDK接下来要跑 Python 示例先把源码版 SDK 装进环境。pixi run py-build底层是maturin develop会把 rerun_py/ 编译出的 rerun-sdk 直接装到 pixi 用 uv 维护的.venv里不需要动系统 Pythonpixi run py-build # 调试版 pixi run py-build --release # 发布版如果你更习惯装 wheel 到自己的环境pixi run py-build-wheels-sdk-only pip install ./dist/CURRENT_ARCHITECTURE/*.whl运行 Python 最小示例确认点云渲染示例脚本 examples/python/minimal/minimal.py 逻辑很短rr.init时spawnTrue自动拉起 Viewer用 numpy 生成 10×10×10 的点阵和三色渐变再一条rr.log发出去。uvpy是 pixi 里跑 Python 脚本的快捷任务pixi run uvpy examples/python/minimal/minimal.py预期效果Viewer 窗口自动弹出my_points实体里渲染出一整块可旋转、缩放的 3D 彩色点云。看到它就是这条最小闭环全部打通了。⚠️ 窗口打不开时先查显卡驱动是否支持 WebGPU不行就开软件渲染Linux 执行export RERUN_ENABLE_SOFTWARE_RASTERIZER1Windows 执行set RERUN_ENABLE_SOFTWARE_RASTERIZER1。界面中文显示异常的话按 F1 打开设置在 Appearance 里把 Font Family 改成系统中文字体重启 Viewer 生效。按需扩展Rust 与 C SDK 编译和示例Rust SDK 就是工作区本身直接 cargo 三连即可文档顺手也生成cargo build --all-features cargo test --all-features cargo doc --all-features --no-deps --open跑一下官方最小 Rust 示例和 Python 版输出的是同一块点云cargo run -p minimal对应源码见 examples/rust/minimal/src/main.rs核心就是建一个RecordingStream、spawn()、再log一个Points3D。C 部分独立在 rerun_cpp/构建走单独的cpppixi 环境它会把编译器切到系统 C/C 工具链所以不进默认环境pixi run -e cpp cpp-build-all # 全量构建 C SDK pixi run -e cpp cpp-test # 跑 C 测试也可以手动走 CMake 编译 examples/cpp/minimal 示例cd examples/cpp/minimal cmake -B build cmake --build build ./build/minimal提速 Rerun 源码编译并配好调试器全量编译慢是 Rust 大型工作区的常态分级处理下面推荐必配是每天都用得上的可选进阶等编译真的痛了再上。推荐必配VS Code 调试与 Rust 插件装三个插件rust-analyzer、CodeLLDB、Crates。然后在项目根目录放一份.vscode/launch.jsonViewer 和 Rust 示例各留一个调试入口{ version: 0.2.0, configurations: [ { name: Rerun Viewer, type: cppdbg, request: launch, program: ${workspaceFolder}/target/debug/rerun, args: [], stopAtEntry: false, cwd: ${workspaceFolder}, environment: [], externalConsole: false, MIMode: lldb }, { name: Rust Example - minimal, type: lldb, request: launch, cargo: { args: [ build, --packageminimal, --binminimal ] }, args: [] } ] }可选进阶链接器加速与 sccache换更快的链接器能显著缩短大编译的收尾阶段。按平台在~/.cargo/config.toml里加对应段落# Linux先 sudo apt install mold [target.x86_64-unknown-linux-gnu] linker clang rustflags [ -C, link-arg-fuse-ld/usr/bin/mold, -C, split-debuginfounpacked, ] # macOS Intel先 brew install michaeleisel/zld/zld [target.x86_64-apple-darwin] rustflags [ -C, link-arg-fuse-ld/usr/local/bin/zld, -C, split-debuginfopacked, ] # macOS Apple Silicon [target.aarch64-apple-darwin] rustflags [ -C, split-debuginfounpacked, ] # Windows先 rustup component add llvm-tools-preview [target.x86_64-pc-windows-msvc] linker rust-lld.exe rustflags [ -C, split-debuginfopacked, ]再叠一层编译缓存cargo install sccache export RUSTC_WRAPPERsccache export SCCACHE_CACHE_SIZE256G平时开发最常用的 pixi 任务速查全量清单用pixi task list看命令作用pixi run check-env环境体检pixi run rerun/pixi run rerun-build编译运行 / 仅编译 Viewerpixi run py-build本地安装 Python SDKpixi run py-build-wheels-sdk-only产出可安装 wheelpixi run -e cpp cpp-build-all/cpp-testC SDK 构建 / 测试pixi run fmt全语言代码格式化收尾自查清单搭完后逐条过一遍全勾上才算这套 Rerun 开发环境就绪☐pixi run check-env通过无版本告警☐pixi run rerun能启动 Viewer 并正常关闭☐pixi run py-build成功Python SDK 装进.venv☐ Python 最小示例跑完Viewer 里渲染出 3D 彩色点云☐ 按需完成cargo run -p minimalRust或pixi run -e cpp cpp-testC想继续深入文档全集docs/content/三语言示例集examples/架构与 crate 分层ARCHITECTURE.md【免费下载链接】rerunVisualize, query, and stream to train on multimodal robotics data.项目地址: https://gitcode.com/GitHub_Trending/re/rerun创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Rerun 开发环境 30 分钟从零到跑通：Viewer 编译 + Python 示例 + 多语言 SDK
Rerun 开发环境 30 分钟从零到跑通Viewer 编译 Python 示例 多语言 SDK【免费下载链接】rerunVisualize, query, and stream to train on multimodal robotics data.项目地址: https://gitcode.com/GitHub_Trending/re/rerun你刚 clone 完 Rerun 仓库目标只有一个30 分钟内把这套 Rerun 开发环境完全跑通——从源码编译启动 Rerun Viewer再跑一个 Python 最小示例让一屏 3D 点云出现在窗口里。前置条件不苛刻Git带 LFS、rustup 管理的 Rust 工具链、pixi 环境管理器只有要碰 C SDK 时才需要额外装 CMake。下面的顺序是先跑通最小闭环再按需扩展每走一步都能确认一个可见的结果。一份工具清单覆盖三端Rerun 安装教程的公共依赖三个系统的核心工具完全相同只有基础安装命令有差异先对照这张总表工具要求版本用途安装方式Git Git LFS最新稳定版克隆仓库、拉取测试资产各平台包管理器 / 官网安装包Rust 工具链1.88.0编译 Viewer 与 Rust SDKrustup install 1.88.0 rustup default 1.88.0Pixi0.41.4统一执行构建 / 测试 / 格式化任务curl -fsSL https://pixi.sh/install.sh \| bash再pixi self-update --version 0.41.4CMake最新稳定版仅 C SDK 编译需要各平台包管理器系统底线Linux 建议 Ubuntu 22.04 GCC 11macOS 13 / Xcode 14Windows 11 / VS 202220.04 / macOS 11 / Win10 是能跑的最低配置。rustup 与 pixi 的安装在三端流程一致Linux 和 macOS 用这一条就够curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y source $HOME/.cargo/env真正有差异的只有这几处Linux先sudo apt update sudo apt install -y build-essential git git-lfs补齐编译器和 LFS。macOSbrew install git git-lfs即可Apple Silicon 用户记得rustup set default-host aarch64-apple-darwin后再装工具链。WindowsGit 安装时勾选 Enable symbolic links装完执行git lfs installrustup 走官网的 rustup-init.exe 默认安装确认 VS 2022 和 Windows SDK 装好编译统一在 VS 提供的命令提示符里跑能省掉大量莫名其妙的链接错误。先跑通最小闭环克隆仓库到 3D 点云渲染克隆仓库并初始化 Git LFS仓库里有大量测试资产走 LFS 通道不 pull 全的话后续示例会缺文件git clone https://gitcode.com/GitHub_Trending/re/rerun.git cd rerun git lfs install git lfs pull进仓库后先跑一次环境体检它会核对所有依赖版本是否符合要求pixi run check-env⚠️ 如果后续编译报linker cc not foundLinux 下基本就是缺sudo apt install build-essential。编译并启动 Rerun Viewerpixi run rerun等价于在 pixi.toml 里定义的那条cargo run --package rerun-clirelease_no_web_viewer 特性首次是全量编译 Rerun 源码确实要等一会儿建议先去倒杯水pixi run rerun # 调试模式编译最快 pixi run rerun --release # 发布模式运行性能最好窗口起来就说明 Viewer 编译这条链路通了。⚠️ 两个常见翻车点报fatal error: EGL/egl.h file not found是缺图形库Linux 执行sudo apt install libegl1-mesa-dev libgl1-mesa-dev libglu1-mesa-devmacOS 执行brew install mesaWindows 上链接错误多半是没在 VS 命令提示符里编译或 VS 2022 / Windows SDK 没装全。本地编译并安装 Rerun Python SDK接下来要跑 Python 示例先把源码版 SDK 装进环境。pixi run py-build底层是maturin develop会把 rerun_py/ 编译出的 rerun-sdk 直接装到 pixi 用 uv 维护的.venv里不需要动系统 Pythonpixi run py-build # 调试版 pixi run py-build --release # 发布版如果你更习惯装 wheel 到自己的环境pixi run py-build-wheels-sdk-only pip install ./dist/CURRENT_ARCHITECTURE/*.whl运行 Python 最小示例确认点云渲染示例脚本 examples/python/minimal/minimal.py 逻辑很短rr.init时spawnTrue自动拉起 Viewer用 numpy 生成 10×10×10 的点阵和三色渐变再一条rr.log发出去。uvpy是 pixi 里跑 Python 脚本的快捷任务pixi run uvpy examples/python/minimal/minimal.py预期效果Viewer 窗口自动弹出my_points实体里渲染出一整块可旋转、缩放的 3D 彩色点云。看到它就是这条最小闭环全部打通了。⚠️ 窗口打不开时先查显卡驱动是否支持 WebGPU不行就开软件渲染Linux 执行export RERUN_ENABLE_SOFTWARE_RASTERIZER1Windows 执行set RERUN_ENABLE_SOFTWARE_RASTERIZER1。界面中文显示异常的话按 F1 打开设置在 Appearance 里把 Font Family 改成系统中文字体重启 Viewer 生效。按需扩展Rust 与 C SDK 编译和示例Rust SDK 就是工作区本身直接 cargo 三连即可文档顺手也生成cargo build --all-features cargo test --all-features cargo doc --all-features --no-deps --open跑一下官方最小 Rust 示例和 Python 版输出的是同一块点云cargo run -p minimal对应源码见 examples/rust/minimal/src/main.rs核心就是建一个RecordingStream、spawn()、再log一个Points3D。C 部分独立在 rerun_cpp/构建走单独的cpppixi 环境它会把编译器切到系统 C/C 工具链所以不进默认环境pixi run -e cpp cpp-build-all # 全量构建 C SDK pixi run -e cpp cpp-test # 跑 C 测试也可以手动走 CMake 编译 examples/cpp/minimal 示例cd examples/cpp/minimal cmake -B build cmake --build build ./build/minimal提速 Rerun 源码编译并配好调试器全量编译慢是 Rust 大型工作区的常态分级处理下面推荐必配是每天都用得上的可选进阶等编译真的痛了再上。推荐必配VS Code 调试与 Rust 插件装三个插件rust-analyzer、CodeLLDB、Crates。然后在项目根目录放一份.vscode/launch.jsonViewer 和 Rust 示例各留一个调试入口{ version: 0.2.0, configurations: [ { name: Rerun Viewer, type: cppdbg, request: launch, program: ${workspaceFolder}/target/debug/rerun, args: [], stopAtEntry: false, cwd: ${workspaceFolder}, environment: [], externalConsole: false, MIMode: lldb }, { name: Rust Example - minimal, type: lldb, request: launch, cargo: { args: [ build, --packageminimal, --binminimal ] }, args: [] } ] }可选进阶链接器加速与 sccache换更快的链接器能显著缩短大编译的收尾阶段。按平台在~/.cargo/config.toml里加对应段落# Linux先 sudo apt install mold [target.x86_64-unknown-linux-gnu] linker clang rustflags [ -C, link-arg-fuse-ld/usr/bin/mold, -C, split-debuginfounpacked, ] # macOS Intel先 brew install michaeleisel/zld/zld [target.x86_64-apple-darwin] rustflags [ -C, link-arg-fuse-ld/usr/local/bin/zld, -C, split-debuginfopacked, ] # macOS Apple Silicon [target.aarch64-apple-darwin] rustflags [ -C, split-debuginfounpacked, ] # Windows先 rustup component add llvm-tools-preview [target.x86_64-pc-windows-msvc] linker rust-lld.exe rustflags [ -C, split-debuginfopacked, ]再叠一层编译缓存cargo install sccache export RUSTC_WRAPPERsccache export SCCACHE_CACHE_SIZE256G平时开发最常用的 pixi 任务速查全量清单用pixi task list看命令作用pixi run check-env环境体检pixi run rerun/pixi run rerun-build编译运行 / 仅编译 Viewerpixi run py-build本地安装 Python SDKpixi run py-build-wheels-sdk-only产出可安装 wheelpixi run -e cpp cpp-build-all/cpp-testC SDK 构建 / 测试pixi run fmt全语言代码格式化收尾自查清单搭完后逐条过一遍全勾上才算这套 Rerun 开发环境就绪☐pixi run check-env通过无版本告警☐pixi run rerun能启动 Viewer 并正常关闭☐pixi run py-build成功Python SDK 装进.venv☐ Python 最小示例跑完Viewer 里渲染出 3D 彩色点云☐ 按需完成cargo run -p minimalRust或pixi run -e cpp cpp-testC想继续深入文档全集docs/content/三语言示例集examples/架构与 crate 分层ARCHITECTURE.md【免费下载链接】rerunVisualize, query, and stream to train on multimodal robotics data.项目地址: https://gitcode.com/GitHub_Trending/re/rerun创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考