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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rerun_sdk-0.38.1-cp310-abi3-win_amd64.whl.
File metadata
- Download URL: rerun_sdk-0.38.1-cp310-abi3-win_amd64.whl
- Upload date:
- Size: 145.5 MB
- Tags: CPython 3.10+, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
maturin/1.14.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
64735766cfbcbd43c8fc7858d8d489fc46db2e56389c9af5f7a449c765039785
|
|
| MD5 |
71937a8d759a16075630940d38acbd3d
|
|
| BLAKE2b-256 |
9272f8db843e961d6a47bfb7cdeabf6c548ad4f9d0e26ffc0d01e6b716b15ba3
|
File details
Details for the file rerun_sdk-0.38.1-cp310-abi3-manylinux_2_28_x86_64.whl.
File metadata
- Download URL: rerun_sdk-0.38.1-cp310-abi3-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 168.4 MB
- Tags: CPython 3.10+, manylinux: glibc 2.28+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
maturin/1.14.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5f6b16374b1af1ecdb7232ed5c7f02f77e908c7c378ce83321479d2610286c0c
|
|
| MD5 |
91081ec9e87c7cc149c5f457a49c5c00
|
|
| BLAKE2b-256 |
3da93156999af1935b85cbe3991d219255c134a008448aff76026b390171b108
|
File details
Details for the file rerun_sdk-0.38.1-cp310-abi3-manylinux_2_28_aarch64.whl.
File metadata
- Download URL: rerun_sdk-0.38.1-cp310-abi3-manylinux_2_28_aarch64.whl
- Upload date:
- Size: 163.0 MB
- Tags: CPython 3.10+, manylinux: glibc 2.28+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
maturin/1.14.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e35e33fd9d6ee69189676b17d3749757a61759e5aca1979532fd2ee3b0fc87c2
|
|
| MD5 |
f4d6ff82ac77832b9063f436bc7f84ed
|
|
| BLAKE2b-256 |
14140bc2a8ab6bbcb1f9e41903794b38b9b91173a94e6ca23806dec64979416b
|
File details
Details for the file rerun_sdk-0.38.1-cp310-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: rerun_sdk-0.38.1-cp310-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 152.5 MB
- Tags: CPython 3.10+, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
maturin/1.14.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c88889be8405ea433a459f32518db5dd5705851c66db31c36fa20ab792ee19e6
|
|
| MD5 |
318cb08c077b858f6a49483bda509750
|
|
| BLAKE2b-256 |
1605543353a15a9440c59a104f4f38832e0fe3fa9489e701c4697ad0685c5539
|
