The data layer for physical AI

The data primitives to build, understand, and improve your data loop. Designed for multi-rate, multimodal data, from the first recording to massive scale.

The open source Rerun Python SDK provides a single toolchain to log, transform, query, view, and train on multi-rate, multimodal data.

Install

pip install rerun-sdk

The Python module is called rerun, while the package published on PyPI is rerun-sdk.

See Install Rerun for the Viewer and other SDK languages.

We also provide a Jupyter widget for interactive data visualization in Jupyter notebooks:

pip install rerun-sdk[notebook]

Example

import numpy as np
import rerun as rr

rr.init("rerun_example_app", spawn=True)

positions = np.vstack([xyz.ravel() for xyz in np.mgrid[3 * [slice(-5, 5, 10j)]]]).T
colors = np.vstack([rgb.ravel() for rgb in np.mgrid[3 * [slice(0, 255, 10j)]]]).astype(np.uint8).T

rr.log("points3d", rr.Points3D(positions, colors=colors))

Resources

• Examples
• Python API reference
• Log and ingest data
• Query and transform data
• Troubleshooting
• Discord

Logging and viewing in different processes

The Viewer and Python logger can run in separate processes. Start the Viewer in one terminal:

python3 -m rerun

In a second terminal, run the example with the --connect option:

python3 examples/python/plots/plots.py --connect

Note that SDK and Viewer can run on different machines! See SDK operating modes for connection options.

Building Rerun from source

Rerun uses pixi for development tools and tasks. Install pixi, clone the repository, and run these commands from its rerun/ directory.

Build and install a development version of the Python SDK:

pixi run py-build

For an optimized build, use:

pixi run py-build-release

Run an example in the development environment:

pixi run uvpy examples/python/minimal/minimal.py

Build a wheel for manual installation:

pixi run py-build-wheel

See BUILD.md for all Viewer and SDK build options.

Installing a pre-release

Development wheels are built for every commit on the main branch:

uv pip install --index https://build.rerun.io/version/main/simple --reinstall-package rerun-sdk rerun-sdk  # latest commit on main
uv pip install --index https://build.rerun.io/commit/<7-char-sha>/simple --reinstall-package rerun-sdk rerun-sdk

--reinstall-package replaces a rerun-sdk that is already installed, even when it has the same version. The main branch can be unstable, so use these wheels at your own risk.

Running Python unit tests

Run the full Python test suite:

pixi run py-test

Build the SDK and run one test file:

pixi run py-build && pixi run uvpy -m pytest rerun_py/tests/unit/test_tensor.py

Profiling the Python SDK

Install puffin_viewer, then set RERUN_PUFFIN=1 when you start a Python program:

cargo install puffin_viewer
RERUN_PUFFIN=1 pixi run uvpy your_script.py

Save a recording from the viewer for offline analysis (use the investigate-puffin skill in .claude/skills/).

For the Viewer side of things, and for tracking down streaming latency, see Diagnose latency and performance.