Skip to main content

Rerun

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

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.

Metadata

Release files for rerun-sdk 0.43.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for rerun-sdk 0.43.2
File Actions
rerun_sdk-0.43.2-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for rerun_sdk-0.43.2-cp311-abi3-win_amd64.whl
rerun_sdk-0.43.2-cp311-abi3-manylinux_2_28_x86_64.whl CPython 3.11 abi3 Linux glibc 2.28+ x86-64 Details for rerun_sdk-0.43.2-cp311-abi3-manylinux_2_28_x86_64.whl
rerun_sdk-0.43.2-cp311-abi3-manylinux_2_28_aarch64.whl CPython 3.11 abi3 Linux glibc 2.28+ ARM64 Details for rerun_sdk-0.43.2-cp311-abi3-manylinux_2_28_aarch64.whl
rerun_sdk-0.43.2-cp311-abi3-macosx_11_0_arm64.whl CPython 3.11 abi3 macOS 11.0+ ARM64 Details for rerun_sdk-0.43.2-cp311-abi3-macosx_11_0_arm64.whl

Total release size: 655.2 MB

Release files / rerun_sdk-0.43.2-cp311-abi3-win_amd64.whl

Download URL rerun_sdk-0.43.2-cp311-abi3-win_amd64.whl
Size 152.6 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
a946736374e5d69a06958b269f4c241747dfba1879eac6c264a4dbedf2eee715
BLAKE2b-256 checksum
How to use checksums
80674effdd62646c27b1b24118f67c49a9a13f8b0416e27bb66d8d58b1e65276
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.14.1

Release files / rerun_sdk-0.43.2-cp311-abi3-manylinux_2_28_x86_64.whl

Download URL rerun_sdk-0.43.2-cp311-abi3-manylinux_2_28_x86_64.whl
Size 175.0 MB
Tags CPython 3.11 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
a811d4c95e181bd4071545809de8c1389fe5372e31dfdcd112aace767901daf1
BLAKE2b-256 checksum
How to use checksums
eac6c2688d46a8b31f23e615538add1aa6d19bf53818ec0ebd696718cf50095a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.14.1

Release files / rerun_sdk-0.43.2-cp311-abi3-manylinux_2_28_aarch64.whl

Download URL rerun_sdk-0.43.2-cp311-abi3-manylinux_2_28_aarch64.whl
Size 170.3 MB
Tags CPython 3.11 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
9bb68f110e111108fa2db64d0ba7068d8011b1b8af5727b256535e0a483bea90
BLAKE2b-256 checksum
How to use checksums
39291c4f680273bac7e208941ebf7faf06b4a85a992ab04d3776318e39407ba8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.14.1

Release files / rerun_sdk-0.43.2-cp311-abi3-macosx_11_0_arm64.whl

Download URL rerun_sdk-0.43.2-cp311-abi3-macosx_11_0_arm64.whl
Size 157.2 MB
Tags CPython 3.11 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
e318537a64aca9368fe5df9a3bb56f197b4f7610a4be76be2202742f05331306
BLAKE2b-256 checksum
How to use checksums
ca303a5dbb633380f57c233e44a28c4a51228c9cb3d695f4ad83235ab7040488
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.14.1

Security for rerun-sdk 0.43.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.43.2 This release

4 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page