The Rerun Python SDK
Use the Rerun SDK to record data like images, tensors, point clouds, and text. Data is streamed to the Rerun Viewer for live visualization or to file for later use.
Install
pip3 install rerun-sdk
ℹ️ Note:
The Python module is called rerun, while the package published on PyPI is rerun-sdk.
For other SDK languages see Installing Rerun.
We also provide a Jupyter widget for interactive data visualization in Jupyter notebooks:
pip3 install rerun-sdk[notebook]
Example
import rerun as rr
import numpy as np
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
You can run the Viewer and logger in different processes.
In one terminal, start up a Viewer with a server that the SDK can connect to:
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!
Building Rerun from source
We use pixi for managing dev-tool versioning, download and task running. See here for installation instructions.
pixi run py-build
This builds the SDK for Python (use pixi run py-build --release for a release build).
You can then run examples via uv:
pixi run uv run examples/python/minimal/minimal.py
To build a wheel instead for manual install use:
pixi run py-build-wheel
Refer to BUILD.md for details on the various different build options of the Rerun Viewer and SDKs for all target languages.
Installing a pre-release
Prebuilt dev wheels from head of main are available at https://github.com/rerun-io/rerun/releases/tag/prerelease.
While we try to keep the main branch usable at all times, it may be unstable occasionally. Use at your own risk.
Running Python unit tests
pixi run py-test
If you run into a problem, run rm -rf .pixi .venv and try again.
Running specific Python unit tests
pixi run py-build && pixi run uvpy -m pytest rerun_py/tests/unit/test_tensor.py
Profiling the Python SDK
Set RERUN_PUFFIN=1 to spawn a puffin_viewer attached to the SDK on startup. The Rust side of the SDK then streams scopes (anything wrapped in re_tracing::profile_function! / profile_scope!) to the viewer for the lifetime of the process.
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/).
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.36.1-cp310-abi3-win_amd64.whl.
File metadata
- Download URL: rerun_sdk-0.36.1-cp310-abi3-win_amd64.whl
- Upload date:
- Size: 140.6 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 |
72c342b10911436c392aee30474366a1ad80db2282d447d338f92727e9c9a36e
|
|
| MD5 |
25ffb0b1a7b0423386e4aa794a69d00d
|
|
| BLAKE2b-256 |
bd7a2089c90e1c57065e4074c41ee2eff30f3f599f60df9f5af722f20aa76d08
|
File details
Details for the file rerun_sdk-0.36.1-cp310-abi3-manylinux_2_28_x86_64.whl.
File metadata
- Download URL: rerun_sdk-0.36.1-cp310-abi3-manylinux_2_28_x86_64.whl
- Upload date:
- Size: 163.0 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 |
4827d8f5551e42a9072f6946c1f796261ce3563fea1f95a89b750b12152f15b8
|
|
| MD5 |
bdc1bc627c0263440e1f2b4019508aad
|
|
| BLAKE2b-256 |
9c2d213b41280869e11d4fa3de4b33073adae5f0ea84c817271cf33ea2b474e6
|
File details
Details for the file rerun_sdk-0.36.1-cp310-abi3-manylinux_2_28_aarch64.whl.
File metadata
- Download URL: rerun_sdk-0.36.1-cp310-abi3-manylinux_2_28_aarch64.whl
- Upload date:
- Size: 157.8 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 |
d067cdaa61e23f456ae2e217187043fb97e10146ad42a2049d45cf0f9f70dba5
|
|
| MD5 |
98c7349614783793c387316795c258dd
|
|
| BLAKE2b-256 |
4005ed2f5225e79cb01940d5faf65cf3045b1fc1baa58d73d641ef15f27b5cb7
|
File details
Details for the file rerun_sdk-0.36.1-cp310-abi3-macosx_11_0_arm64.whl.
File metadata
- Download URL: rerun_sdk-0.36.1-cp310-abi3-macosx_11_0_arm64.whl
- Upload date:
- Size: 147.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 |
6323d6c22ccdcb9aad5d507044e8aef43ac0f0c97cd98b1c90d63b09b0d372b1
|
|
| MD5 |
67a2e104ba7bce774e625883b3c812ef
|
|
| BLAKE2b-256 |
b8b9eb4355b862a4afabf1a3ec2a472e32fe668919a1933bea96a7e4f6891ae1
|
