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 built from the latest main branch are available from the prerelease release.
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.
1 maintainer
Release files for rerun-sdk 0.38.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| rerun_sdk-0.38.1-cp310-abi3-win_amd64.whl | CPython 3.10 | abi3 | Windows x86-64 | Details |
| rerun_sdk-0.38.1-cp310-abi3-manylinux_2_28_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| rerun_sdk-0.38.1-cp310-abi3-manylinux_2_28_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| rerun_sdk-0.38.1-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details |
Total release size: 629.4 MB
Release files / rerun_sdk-0.38.1-cp310-abi3-win_amd64.whl
| Download URL | rerun_sdk-0.38.1-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 145.5 MB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
64735766cfbcbd43c8fc7858d8d489fc46db2e56389c9af5f7a449c765039785
|
|
BLAKE2b-256 checksum How to use checksums |
9272f8db843e961d6a47bfb7cdeabf6c548ad4f9d0e26ffc0d01e6b716b15ba3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.14.1
|
Release files / rerun_sdk-0.38.1-cp310-abi3-manylinux_2_28_x86_64.whl
| Download URL | rerun_sdk-0.38.1-cp310-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 168.4 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
5f6b16374b1af1ecdb7232ed5c7f02f77e908c7c378ce83321479d2610286c0c
|
|
BLAKE2b-256 checksum How to use checksums |
3da93156999af1935b85cbe3991d219255c134a008448aff76026b390171b108
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.14.1
|
Release files / rerun_sdk-0.38.1-cp310-abi3-manylinux_2_28_aarch64.whl
| Download URL | rerun_sdk-0.38.1-cp310-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 163.0 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
e35e33fd9d6ee69189676b17d3749757a61759e5aca1979532fd2ee3b0fc87c2
|
|
BLAKE2b-256 checksum How to use checksums |
14140bc2a8ab6bbcb1f9e41903794b38b9b91173a94e6ca23806dec64979416b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.14.1
|
Release files / rerun_sdk-0.38.1-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | rerun_sdk-0.38.1-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 152.5 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c88889be8405ea433a459f32518db5dd5705851c66db31c36fa20ab792ee19e6
|
|
BLAKE2b-256 checksum How to use checksums |
1605543353a15a9440c59a104f4f38832e0fe3fa9489e701c4697ad0685c5539
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.14.1
|
